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Preface 








MPSIM is a discrete-event simulator designed to imitate operation of Micro- 
chip Technology’s PIC16C5X and PIC16CXX families of microcontrollers. 
Device specific information is provided in the appendices at the end of the 
manual. It is a tool that has been created to assist the user in debugging 
software that will use any of these parts. 


A discrete-event simulator, as opposed to an in-circuit emulator, is designed 
to aid in the debugging of the general logic of your software. The MPSIM 
discrete-event simulator allows the user to modify object code and immedi- 
ately re-execute, inject external stimuli to the simulated processor, and trace 
the execution of the object code. A simulator differs from an in-circuit emula- 
tor in three important areas: cost, I/O timing, and execution speed. 


The cost of the debugging tool may be an issue with some developers. For 
this reason, Microchip Technology has developed this simulator to be a cost- 
effective tool for debugging application software. MPSIM does not require 
any external hardware to the PC, which keeps the cost at a minimum. 


External timing in MPSIM is processed only once during each instruction 
cycle. Transient signals, such as a spike on MCLR smaller than an instruc- 
tion cycle will not be simulated but may be caught by an in-circuit emulator. 
In MPSIM, external stimulus is injected just before the next instruction cycle 
execution. 





The execution speed of a discrete-event simulator is several orders of 
magnitude less than a hardware-oriented solution. Users may view slower 
execution speed as a handicap or a blessing. Some discrete-event simula- 
tors are unacceptably slow. MPSIM however, attempts to provide the fastest 
possible simulation cycle. 


The simulator, however, is a great debugging tool. It is particularly suitable 
for optimizing algorithms. Unlike the emulator, the simulator makes many 
internal registers visible and can provide more complex break points. 


If you are a new user, refer to Chapter 3 for a "Getting Started" tutorial. 


meme ime te meee mimi em me Tan ecmmmeinioeeemeiemmemnsnsenenernenenecenseceeeenemeeeece eeepc 
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MPSIM is a discrete-event simulator designed to aid you in debugging your 
software applications for Microchip Technology’s PIC16C5X and PIC16CXX 
microcontrollers. 


Whether you are an experienced user or a beginner, we strongly suggest that 
you read this chapter first since it provides information about: 


¢ — Installing MPSIM 

¢« Documentation conventions 

¢ Device-specific support 

¢« Customer support information. 


If this is your first time using MPSIM we also suggest that you go through the 
tutorial provided in Chapter 3. This tutorial introduces all files that are used 
or generated by the simulator and provides a good introduction to some of 
the most widely-used commands. 


Installing MPSIM 


System Requirements 


MPSIM requires an IBM® PC or compatible running DOS version 3.0 or later. 
The PC needs a 3 1/2 inch floppy disk drive and at least 640K main memory. 
We recommend a hard disk with at least 5 MB of available space. 


* On the PC, create a new directory for the MPSIM software and change to 
that directory: 


MKDIR SIM<RETURN> 
CD SIM<RETURN> 

* Copy all the files on the MPSIM diskette into the above directory: 
COPY a:\*.* 

After loading the software, MPSIM is ready to run. 


aR IR PI ER PPS PPE AI A NPT POE SSPE BT RA A ATCT TEED PEP TS SICA ES ITE TCC TTT ETC A TOS TT I TL T I 


© 1994 Microchip Technology Inc. DS30027H - page 3 


MPSIM USER’S GUIDE 


Document Conventions 


Terminology 


This section describes the conventions this manual uses for the data you are 
to enter. 


TABLE 1.1 - CHARACTER CONVENTIONS 


(Character = Represents SC” 
Square ([]) brackets | Optional arguments 
Angle (<>) brackets Delimiters for special keys: <TAB>, <ESC>, etc. 


Pipe(|) characters Choice of mutually exclusive arguments; an OR selection 
Type of data 


Italic characters A variable argument; it can be either a type of data (in lower 
case Characters) or a specific example (in uppercase 
characters) 


User keyed data or output from the system 





Break Points 

Source code locations where you want the code to cease execution. 
Program Counter (PC) 

The address in the loaded program at which execution will begin or resume. 
Disassembler 


Converts modified object code back into assembly-language code when a 
listing file wasn’t loaded. Thus, mnemonic information can display even 
when you have made changes. 


Step 


A single executable instruction. You can single-step through a program by 
executing one instruction at a time with the SS command. A stimulus file can 
inject values onto specified pins at specified steps. 


Symbols 


Alphanumeric identifiers such as labels, constant names, bit location names 
and file register names. MPSIM understands both explicit data/addresses 
and symbols. 
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Trace 


A trace file can be created to illustrate the execution flow of your program. 
Each line in the trace file contains the object code, source line, step number, 
elapsed time, and file registers that have changed. Trace can be limited to a 
range of addresses, or to a specific file register address. Please see Chapter 
3 "Getting Started" for examples on the trace file. When you trace the 
instructions, they always display on the screen. If you previously opened a 
trace file and have not closed it, MPSIM also appends the trace to the file. 


View screen 


The portion of your monitor that dynamically displays the values in specified 
data areas. It is seven lines long. The V command creates a view screen; 
the AD command adds data areas to the display; the DV command deletes 
data area from the display; and the NV command deletes all data areas from 
the view screen. 


Device-Specific Support 


MPSIM v. 4.x provides support for more than one family of microcontrollers. 
Chapters 1 - 5 contain general information about MPSIM, regardless of the 
target processor. Device-specific information can be found in the appendices 
at the end of this manual. 


Customer Support 


If you have any questions about MPSIM, the first step is to check in Appendix A, 
which contains a troubleshooting guide that provides some common error 
messages and their possible causes. Appendix B provides detailed informa- 
tion about how to connect to the Microchip Technology BBS. The BBS 
contains the most up-to-date development systems software, application 
notes, as well as a variety of other useful information. If you still cannot find 
the answer, contact the sales office nearest you. Information and telephone 
numbers are presented in Appendix C. 
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Chapter 2. The MPSIM Environment 





Chapter 2 provides an introduction to the MPSIM debugging environment. It 

describes all data areas that can be simulated and presents general informa- 
tion about using the simulator. This chapter is highly recommended for first- 

time users. 


The following topics will be covered: 


User Interface 


Layout of the User Interface 

I/O Pins 

CPU model including reset, sleep, WDT, registers and stack 
Files Used and Generated by MPSIM 

Object-Code Formats 

Invoking MPSIM 


The user interface consists of three areas: the title line, the view screen and 
a command entry/display region. The title line remains in a fixed location at 
the top of the screen and lists the current object file, the radix, the MPSIM 
version, the controller being simulated, cycle steps and elapsed time. 


Title Line 


View Screen 


Command Entry 


RADIX=X — MPSIM 4.15 16055 TIME= .Ubp UO 





Figure 2.1 - Start-up 
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The view screen displays user selected pin and register values. This area is 
created by the user typically through an initialization command file. This file 

will be in greater detail later in this chapter in "Files Used and Generated by 

MPSIM". 


The command entry/display region occupies the remainder of the screen. 
Use this area to enter commands; MPSIM enters any responses to a com- 
mand on the line or lines immediately following the command. 


MPSIM can be invoked with any or a combination of the following options: 


verbose 
monochrome mode 
MPASM assembler support 


MPALC assembler support 
ASCII only 





Invoking MPSIM The ‘%’ is MPSIM’s prompt. Enter an object code filename. If you do not 
specify the extension, MPSIM will assume .OBJ for MPALC and .HEX for 
MPASM. To load a file into the simulator, use the following command: 


%LO filename [FORMAT] <RETURN> 


I/O Pins 


There is a list of viewable and modifiabie pins for each microcontroller in its 
appendix. These pin names are the only ones that MPSIM recognizes as 
valid. 


I/O Pin Modeling 


Because a conflict can occur when a pin is being driven internally (via an 
instruction) and externally (via stimulus file), the following table is provided to 
illustrate the possible conditions and the order in which MPSIM processes it. 


Is the pin being Is the pin being Resolution | | 
driven externally? | driven internally? 

The pins are essentially floating. The pins maintain the last 

external value they were driven. | 

pyes [No Simpl 






* Note that this does not represent the actual behavior of the circuit when the I/O pin was last driven by 
the chip. However, typically, a used 1/O pin (especially CMOS) would not be left floating. 
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CPU Model 


Pin Signals 


At the end of each instruction all pins are checked for possible input or 
output. 


* Ifthe RTCC/TMRO pin is changed, the RTCC/TMRO timer register 
increments in accordance with the prescaler. 


¢ Ifthe MCLR pin is cleared, MPSIM simulates a MCLR reset. 





¢ The TRIS status register bits determine how MPSIM manipulates the port 
and file register bits. For example, the TRISA, RAO-RA5 and F5 registers 
work together; the TRISB, RBO-RB7 and F6 registers work together; and 
the TRISC, RCO-RC7 and F7 registers work together, etc. 


- For TRIS status register bits that are set, MPSIM reads the corre- 
sponding port bit into the corresponding file register bit. 


- For TRIS status register bits that are cleared, MPSIM writes the 
corresponding file register bit to the corresponding port bit (pin). 


* Similarly, if any of the timer inputs are changed, the corresponding timer 
or its prescaler will increment. 


« Any peripheral input (such as capture input) is acted upon. 


¢ Any peripheral output (such as serial port output) is presented on the pin. 


Reset Conditions 
All reset conditions are supported by MPSIM. 


A Power-On-Reset, for example, can be simulated by using the RS instruc- 
tion. All special-purpose registers will be initialized to the values specified in 
the PIC16C74 data sheet. 


A MCLR reset during normal operation or during SLEEP, for example, can 
easily be simulated by driving the MCLR pin low (and then high) either via the 
stimulus file or by using the SE command. 





A WOT time-out reset is simulated when WDT is enabled (see DW com- 
mand) and proper prescaler is set (by initializing OPTION register appropri- 
ately) and WDT actually overflows. WDT time-out period is approximated at 
18 ms (to closest instruction cycle multiple). 


The Time-out (TO) and Power-down (PD) bits in the Status register reflect 
the reset condition. This feature is useful for simulating various power-up 
and time out forks in the user code. 
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Sleep 


MPSIM simulates the SLEEP instruction, and will appear “asleep” until a 
wake-up from sleep condition occurs. For example, if the Watchdog timer 
has been enabled, it will wake the processor up from sleep when it times out 
(depending upon the prescaler setting in the OPTION register). 


Another example of a wake-up-from-sleep condition, would be Timer1 wake- 
up from sleep. In this case, when the processor is asleep, Timer1 would 
continue to increment until it overflows, and if the interrupt is enabled, will 
wake the processor on overflow and branch to the interrupt vector. 


Wake-up from SLEEP through interrupt is fully simulated in the PIC16CXX 
products. 


WDT 


The Watchdog timer is fully simulated in the MPSIM simulator. Because it is 
fuse-selectable on the device, it must be enabled by a separate command 
(see the DW command) in MPSIM. The period of the WDT is determined by 
the prescaler settings in the OPTION register. The basic period (with 
prescaler = 1) is approximated at 18 ms (to closest instruction cycle multiple). 


Registers 


MPSIM simulates all registers. Certain special-function registers or non- 
mapped registers can be added to the viewscreen or modified like any other 
register. Examples are timer prescaler or postscalers. 


All registers are initialized appropriately at various reset conditions. 


Please see the appendix of the microcontroller in question for a list of 
additional registers. 


[RegieterNane [Function 


* Processor-dependent. For a complete list for a given processor, please 
refer to the device-specific appendix. 
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Hardware Stack 
Push 


The CALL instruction pushes the PC value + 1 to the top of the stack and 
loads the PC with the address of the subroutine being called. If the number 
of CALL instructions exceeds the depth of the stack, MPSIM will issue a 
“STACK OVERFLOW” warning message when executing or single-stepping 
through code. In the PIC16C5X family, the CALL instruction is the only 
instruction that causes an address to be pushed to the stack. The 
PIC16CXX family however, supports interrupts. When an interrupt occurs, 
the PC value + 1 is pushed to the stack and the PC is loaded with the 
address of the interrupt vector (0x004). The same error message will also be 
generated if too many addresses are pushed to the stack when MPSIM is 
executing or single-stepping through a program. 


Pop 


RETLW instructions in the PIC16C5X and RETLW, RETURN and RETFIE 
instructions in the PIC16CXX instruction set remove or “pop” the last address 
pushed to the stack and loads its value into the PC. If an attempt is made to 
pop more values than the stack contains, MPSIM will issue a “STACK 
UNDERFLOW’” warning message when executing or single-stepping through 
the program. 


Because stack implementation is processor-family dependent, please refer to 
the appendix of the processor family in question for stack simulation. 


Files Used and Generated By MPSIM 


MPSIM uses or creates the following |/O files. 
¢ Command files 

¢ Initialization files 

¢ Journal files 

¢ Stimulus files 

« Assembler files 

¢ HEX-Code formats 


The following sections describe each of these files. 
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Command Files 


Command files are text files containing MPSIM commands. These MPSIM 
commands are executed with the GE command. 


There are two special command files: MPSIM.INI and MPSIM.JRN. 
MPSIM.INI is the initialization file that MPSIM will automatically load on start- 
up. MPSIM.JRN is a file containing all commands executed in the previous 
session. 


Initialization File 


When MPSIM is invoked, it automatically performs the MPSIM commands in 
MPSIM.INI. Common commands in this file might create a standard view 
screen and/or initialize data areas. Figure 3.2 in Chapter 3 lists an example 
initialization file and Figure 3.3 in Chapter 3 shows the resulting view screen. 


Journal File 


If you want to re-execute the most recent MPSIM session, LJ retrieves a list 
of the commands performed during the previous MPSIM session from 
MPSIM.JRN. This file is automatically created each time MPSIM is invoked. 
If you want to retain a journal file, copy it to another filename before reenter- 
ing MPSIM. The first time you reenter MPSIM, the journal file is the same as 
you copied. However, when you exit via Q, the commands from the current 
MPSIM session will overwrite the previous journal file. Thereafter, you can 
access the copied file with GE. 


As with all modern CAD/CAE tools, the concept of journal files is carried 
throughout MPSIM. That is, any command entered by the user is automati- 
cally stored in a journal file (named MPSIM.JRN). The journal file remains in 
the user’s default directory regardiess of the termination method (Quit or 
Abort). The LJ command loads and executes the journal file created during 
the previous simulator session. However, it doesn’t store the commands from 
the previous journal file in the current journal file. . 


Performing the Q command removes the previous journal file, but using the 
AB (Abort) retains old journal file. The current MPSIM session commands 
are written over the previous journal file. 


Stimulus File 


This file allows you to schedule bit manipulation by forcing MPSIM to drive 
given pins to given values at a specified input step. This scheduling is via a 
text file called a stimulus file. The stimulus file can force any pin to any value 
at any input step during program execution. The ST command reads the 
stimulus file into MPSIM. When you execute the .OBJ file with E, each time it 
looks for input, it reads the next step in the stimulus file. The first line of 
stimulus file always consists of column headings. It lists first the word 
“STEP,” followed by the pins that are to be manipulated. The data below 
STEP represents the object file’s input request occurrence. The data below 
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each pin name is the input value. You may enter comments at the end of a 
line by preceding it with an exclamation mark (!).. The following example 
illustrates the stimulus file format: 


STEP pin 1 pin 2 ! These are node names 
8 1 0 ! followed by values 
16 0 1 

24 1 0 


Other notes on the format of stimulus file: 


e The steps in the stimulus file must be decimal, regardless of the radix in 
which you run your simulation 


¢« The number of spaces separating data tokens is irrelevant 


¢ Backslash (\) is a continuation mark at the end of a line and indicates that 
the following line continues the statement from the current line 


| Step RTCC | pas | RAZ | RA1 | RAO | ! Column Headings 

| 3} of of 1 {o] o | ! Stimulus before cycle 3 
ey : za or | ad ! Injected before cycle 4 
Pe a aye. | 1 PO ! Injected before cycle 9 
RAERES 


1 1 ! Injected before cycle 10 


| Ea 
| o | o | o | o | ! Injected before cycle 15 
po} of o |] 4 | ! Injected before cycle 16 


Figure 2.2 - Stimulus File 





Loe 
ex 
a ee 


Files Generated by the Assembler 


The MPALC and MPASM assemblers generate by default all files necessary, 
for use with MPSIM. To assemble a file, invoke MPALC or MPASM with the 
source file name as follows: 


MPALC filename 
or 
MPASM filename 


The default assembler that MPSIM assumes is MPASM. To specify MPALC 
as the assembler, invoke MPSIM with the "-s" option. 
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Listing File 


The listing file contains the source code the assembler uses to create the 
object code being simulated. To display the source code throughout simula- 
tion, read in the listing file with the LO command. Otherwise, MPSIM uses 
the disassembler. 


Input Object File 


The input object file contains the object code generated by the assembler. 
The LO command reads an object file directly into program memory. The 
object code format can be INHX8M or INHX8S. The default format is 
INHX8M. 


Output Object File 


At any time during simulation, the contents of the program memory can 
written to an external file with the O command. The object code format can 
be INHX8S or INHX8M. 


Symbol File 


The assembler generates the symbol file and contains a collection of sym- 

bols used in the source code. This file is used for symbolic debugging, and 
is automatically loaded when the LO command is used. The RA command 
clears the symbol file, and restores all original values. 


Trace File 


If you open a trace file with the TF command and later trace execution, 
MPSIM writes the specified trace into the trace file as well as displaying the 
trace on-line. 


HEX Code Formats 


The simulator is capable of reading or generating two different object code 
formats as dictated by the LO and O commands: INHX8S or INHX8M. The 
default object-code format that the simulator recognizes is INHX8M, but any 
file format can be loaded by specifying the format when using the LO com- 
mand. For example: 


LO Myfile INHX8S 


will tell the simulator to load myfile.obh and myfile.obl. (The two files neces- 
sary for INHX8S format.) Similarly, modified object code can be saved to 
disk in any format by using the following command: 


O Myfile INHX8M 


The file that has been loaded into memory in any format will now be saved as 
a file in INHX8M format. 
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Chapter 3. Tutorial 





Overview 


This chapter provides an introduction to MPSIM, the discrete-event simulator 
for Microchip Technology’s PIC16C5X and PIC16CXX families of microcon- 
trollers. It also presents a step-by-step tutorial through a sample program, 
SAMPLE.ASM. The tutorial is intended to familiarize you with the simulator 
and to provide an introduction to some of the most commonly used com- 
mands. The source code for SAMPLE.ASM and the other files used in the 
tutorial are available on your master disk, and can also be found in Appendix 
B at the end of the manual. If you do not have soft copies of the files for the 
tutorial, they can be created with any ASCIl text editor. It is assumed that 
MPASM v. 1.X and MPSIM v. 4.x have been installed on your hard drive, and 
that all files used in the tutorial are in your working directory. 


The program that is used in this tutorial, SAMPLE.ASM, is a software multi- 
plier that takes two 8-bit numbers, “mulplr’ and “mulcnd”, and places the 16- 
bit result in “H_byte” and “L_byte”. 


Because this chapter provides some background examples in addition to the 
tutorial, all steps that are part of the tutorial will have a step number in bold 
text to the left of the command in the margin. 


Assemble the Code 


Before you can begin to use the simulator, you must first assemble 
SAMPLE.ASM. MPASM generates an object file in INHX8M format by 
default. In addition to INHX8M, the following formats can be output by either 
assembler: 


INHX8M 
INHX8S 


There is one default setting that the simulator assumes when it loads your 
code: the file format. The default file format for MPSIM is INHX8M, but any 
format that either assembler generates can be loaded into the simulator. 


For this tutorial, we want the output file format to be INHX8M (the default 
format used by MPSIM), and the processor type to be PIC16C54. Type the 
following at the DOS prompt: 


MPALC sample /p 16C54 <RETURN> 
or 
MPASM sample /p16C54 <RETURN> 
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Invoke the Simulator 


To invoke the simulator, simply type 


MPSIM<RETURNs (if using the MPASM assembler) 


or 
MPSIM -s<RETURN3> (if using the MPALC assembler) 
at the DOS prompt. 


The following screen will display: 


RADIX=X MPSIM 4.15— B istoxs}s) TIME=6 .00» 6 


: 68 Fi: 66 F2: 106 F3: 66 F4: 66 FS: 6B F6: GB F?: 86 





Figure 3.1 - MPSIM.INI View Screen 


MPSIM.INI Observe the information in the command area and the information that is 
displayed in the view screen. The data areas appear in the view screen 
because an initialization file, MPSIM.INI is in your working directory. 
MPSIM.INI is simply an ASCII file that contains the same commands that 
appear in the command area. Every time MPSIM is invoked, it looks for a file 
called MPSIM.INI. If one exists on your working directory, all of the MPSIM 
commands appearing in that file will be executed, much like a DOS batch file. 
It is important to understand that an initialization file can be named anything. 
MPSIM.INI is unique in that it is automatically loaded when MPSIM is in- 
voked. 


IRENA LN PATS EEO SY IT ST RR TI TT SHR AT SSE TE BS LE GT SE ETE TS ESS EI LE YE ASE SSE SEE HT ET OE TET I I NTS RS LT TTI EE ED 
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Load the Initialization File 


Creating an 
initialization file 


Initialization files are very useful because they allow you to choose data 
areas that you wish to view, display them on the viewscreen, load your 
program, and create break points—all in one step. In other words, you can 
invoke MPSIM, load your initialization file, begin debugging, exit MPSIM, and 
return later, easily setting up the viewscreen the same way that you had it 
when you quit the program, simply by loading the initialization file. 


One easy way to create an initialization file is to first invoke the simulator, 
type in commands that set up your viewscreen, set some break points, and 
then quit the simulator. When you quit, you will notice that a file 
“MPSIM.JRN” has been created. This “journal” file contains every command 
that you executed in the previous session. If the W register, or any other 
register was added to the viewscreen, the commands implementing this will 
be saved in the journal file. This file can then be edited using any text editor 
to remove commands such as “E” (execute) or “Q” (Quit), and then saved 
under another file name. It is necessary to remove commands such as “E” 
and “Q” because they will also be executed when you load your 
ANYTHING.INI file, and the simulator would set up your viewscreen, execute 
your code, and quit. It is also important to save the journal file under another 
name before invoking MPSIM a second time. Each time MPSIM is invoked, it 
overwrites the previous journal file, and if you did not rename the journal file, 
it will contain all commands executed in the current session. 


For this example, we will use the initialization file called “SAMPLE.INI”. We 
will load it by using the following command: 
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GE sample.ini <RETURN> 


MPSIM executes the commands in the following SAMPLE.INI file. 


LO SAMPLE 
ST SAMPLE 
SR X 

ZP 

ZR 

ZT 

RE 

P 54 

NV 

AD mulcnd 
AD mulplr 
AD H_byte 
AD L_byte 
AD count 
AD portb 
AD RB7,B,1 
AD RB6,B,1 
AD RB5,B,1 
AD RB4,B,1 
AD RB3,B,1 
AD RB2,B,1 
AD RB1,B,1 
AD RBO,B,1 





Figure 3.2 -Sample .INI Initialization File 


This changes the viewscreen so that it displays the data areas that 
SAMPLE.OBJ uses, in the most useful format. 


RADIX=X MPSIM 4.15 16c54 TIME=6.60p 6 


tIcnd: 68 mulplr: GB H _byte: 8 L_byte: @@ count: @8 porth: FF RB?: 1 
> 1 RB4: 1 RB3:.1 RB2: 1 RBI: 1 RBA: 1 


H_byte 
L_byte 
count 
portb 
RB?,B,1 
RB6,B,1 
RBS,B,1 
RB4,B,1 
RB3,B,1 
RB2,B,1 
RB1,B,1 
RBO,B,1 


Processor Reset 
341296 bytes memory free 





Figure 3.3 — Sample.INI View Screen 


The commands in this file create the viewscreen shown above and re- 
initialize data areas. The viewscreen now contains data areas that can be 
watched during the execution of SAMPLE. 
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Load the Hex File 


Notice that the LO command is listed in the SAMPLE.INI file. Because of 
this, the object file was automatically loaded when SAMPLE.INI was loaded. 
If the LO command were not in the SAMPLE.INI file, you could load the file by 
typing in the following: 


LO sample <RETURN> 


It is important to realize that because we have assembled the code in the 
MPSIM default format (INHX8M), we do not have to specify the format being 
loaded. If we had assembled filename in any format other than INHX8M, we 
would have had to load the file in the following way: 


LO filename format <RETURN> 


MPSIM loads the named object file, and then looks for a source file. If the file 
is available, it also loads the symbol table and the listing file. 


Load the Stimulus File 


SAMPLE. INI has taken care of loading the stimulus file. You can see in the 
SAMPLE.INI file that the command: 


ST sample.sti <RETURN> 


was executed when the initialization file was loaded. 


The stimulus file contains values that are to be input to the pins. When you 
execute the loaded program, at every instruction step specified in the stimu- 
lus file, MPSIM retrieves the input data, and injects their values to the pins. 


B7 RB6 RBS RB4 RB3 RB2 RB1 RBO !PortB Pins 
0 1 1 !9x 5 


! 10 
! 27 
ie Be 


64 


R 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 


ol oo Rohe Rook) 
oo Ro Roo Noho non~) 
FOOrFOGrRAGOG0OO 
FOSCOOrFOFOSO 

FP OrRFGOCOrFROFSO 
FPOrFORFPFOrFOSO 
RPORRFPRFPRFPRPOPR 





Figure 3.4 - SAMPLE.STI Stimulus File 


The stimulus file for SAMPLE in figure 3.4 writes the multiplier and multipli- 
cand values into simulated I/O port B. Since this port allows up to eight bits 
of data, the maximum value of the multiplier and multiplicand is 11111111 or 
OxFF. 
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Set Up Trace Parameters 


Exercise 1: 


A trace file is a file that contains executed instructions, timing information, 
and registers that have been modified. Using a trace file can be very helpful 
in determining where to inject stimulus and for creating a “hard copy” of the 
general execution flow of your program. There are five MPSIM commands 
dealing with traces: 

¢ TF opens and closes a file for writing the traced data. 

¢ TA traces all instructions between two specified addresses 

¢ TC traces a specified number of instructions. 

¢ TR traces instructions dealing with specified registers and values. 

¢ DX displays the current trace parameters 


Try some of the following exercises. All of the traces in these exercises will 
be printed to a file. If you would like to try printing your trace to a default 
printer, substitute “PRN” in place of the trace file name. 


Trace the instructions between two labels, call_m and main, and print 
the instructions to a file. 
The first step is to create the trace file: 

TF trace1.trc <RETURN> 


Next, specify the range of the trace. Then, begin tracing the instructions. Hit 
any key to interrupt the trace. 


TA main, call_m <RETURN> 
TC <RETURN> 


SS EF a SS SSP ET SE EE I ET TEE SL SE SS TS ES STD 
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Exercise 2: 


Exercise 3: 


Trace fourteen instructions (Ox0E instructions) and write the trace to 
the file TRACE2.trc. 


Restart the system by exiting MPSIM (q <RETURNS>), and repeating steps 2 
(Invoke the Simulator) and 3 (Load the Initialization File). Just as in Exercise 
1, we will first open the trace file 


TF trace2.trc <RETURN> 


Then, we will trace the next fourteen instructions. Note that if the number of 
instructions to be traced is not specified, the trace will continue until a key is 
pressed. 


TC E <RETURN> 


Note: If you had specified the number of instructions to be executed as 


“14” instead of “E”, twenty steps would have been executed since 
the radix is set to hexadecimal (the default radix in MPSIM). 


RADIX=X MPSIM 4.15 16c54 TIME=32 .00p 14 


>: 69 mulplir: FF H_byte: 66 L_byte: 88 count: 68 portb: O05 RB?: G 
RBS: @ RB4: @ RB3: 6 RB2: 1 RB1: GO RBO: 1 


: file is open (trace2.trc) 


goto start 
start clrw 
option 
main mouf porth.w 
movuuf mulpir 
movuf porth,w 
mouuwt muicnd 
call mpy_S 
cirf H_byte 
clrf L_byte 
movlu 8 
mouwf count 
mouf mulcnd ,w 
bef STATUS , CARRY 





Figure 3.5 — The trace information is printed to both the screen and the 
trace file. 


Check the current trace criteria. 


DX <RETURN> 


The current trace parameters display in the command entry area of the 
MPSIM screen. 
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Set Up Break Points 


Break points are used to artificially stop program execution so that you can 
review how the data has been manipulated or to see the contents of the 
Status Register. There are three instructions that deal with break points: 


¢ DB displays all of the break points currently set. 
¢ BC clears one or all of the break points currently set. 


¢ B- sets a break point. 


Exercise 1: _ Initialize the break points by clearing any break points currently set. 
Enter the following command: 


BC 
Exercise 2: Seta break point at MPY_S. Enter the following command: 


B mpy_S<RETURN> 


Exercise 3: Review all the break points. Enter the following command: 


DB<RETURN> 


Exercise 4: Delete the break point at MPY_S. Enter the following command: 


BC mpy_S<RETURN> 


EA A SE ARATE I PEPSICO AA A TT ALAC 6 AT SECEDE AIOE OE EE SE EET AE I EE PEE ES SE LE TOSI a OTTO EET ICAL E ESTED 
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Execute the Object Code 


In addition to trace, there are three instructions that you can use to execute 
your code. 


E 
SS 
Cc 


¢ E executes your code until it encounters a break point or you press a 
key. 


¢ $S single-steps through your instructions. That is, it executes one single 
instruction at the CPC. 


¢ C_ Execute, ignoring “n” number of break points. 


Exercise 1: | Adda watch variable. Add the w register to the display. 


AD W <RETURN> 
Exercise 2: Add two break points and execute until the first break point is 
encountered. 
b main 
bmpy_S 
E <RETURN> 


MPSIM executes until it encounters the first break point or until a key is 
pressed. Watch the values change in the W, mulpir, H-Byte, and L-Byte 
registers. 


Exercise 3: Execute instructions one step at a time. 


SS <RETURN> 


The SS instruction causes MPSIM to execute the instruction at the PC. 
Pressing <RETURN> at the MPSIM prompt re-executes the last command. 
Execute a second instruction by pressing <RETURN> again. Do this several 
times, watching how the values in the W, mulplir, H-Byte, registers change. 
This command can be used to single-step through your entire program to 
see the data values at each step, and to watch the flow of your program. If 
you supply an address with the SS command, MPSIM will modify the CPC to 
the address you specify and then will execute the instruction at that address. 
Remember that pressing <RETURN> will cause MPSIM to re-execute the 
same command, so that if you supplied an address with the command, the 
same address will be executed. 
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Exercise 4: 


Execute your program and break after the second break point. 


C 2<RETURN> 


MPSIM executes the instruction at the current CPC until the instruction 
immediately following the second break point. Watch the values change in 
the W, mulplr, H-Byte, and L-Byte registers. 


Modify the Object Code 


Exercise 1: 


Exercise 2: 


MPSIM has four types of commands which allow you to modify the object 
code: search commands locate code that match specified criteria, display/ 
modify commands automatically display specified code and allow you to 
change it, delete commands eliminate specified code, output commands 
allow the modified code to be saved to a file. For the following exercises, 
mulpir is stored in file register F10. 


Search for the next occurrence of F10, and change its contents to OxFF. 


SF 0, 1FF, F10 <RETURN> 
You will see two code lines with the "mulplr" register label. 
F F10 <RETURN> 


After you type in the above command, you will see the current contents of 
register F10, followed by a colon. Type in the value OxFF, and watch the 
contents of the file register change. You will see that the contents of “mulplr’ 
will change since the value of “mulpir’ is 0x10. 


Change the value of the W register to 0x0C 


W <RETURN> 


Just as in Exercise 1, you will see the current contents of W displayed on the 
screen, followed by a colon. Type in Ox0C, and watch the contents of the W 
register change. 


Sa EAP A DP SE ST SL IS IB RISE RS SSB SE DSS OSS SE IE TD I EE ET CEI EPSPS ETE HII EIEIO LT I EI TOS IED SEE LETS TIES ASIST CEI EDEN EY EEL DIRT 
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Exercise 3: Change the contents of program memory located at the PC to a NOP. 


Type in the following: 
M 0 <RETURN> 


You will see the contents of program memory displayed in hexadecimal, 
followed by a colon. Type in a 0 (object code for NOP), and then <RE- 
TURN>. Unlike modifying file registers, you will not immediately exit the 
function. Instead, you will see the contents of the next memory location 
followed by acolon. You can continue modifying program memory until you 
are finished. When you are done, type “Q”. This will get you back to the 
MPSIM command prompt (%). 


Exercise 4: Delete program memory between address 2 and 4. 


Type in the following command: 


DE 2,4 <RETURN> 


This function will delete all program memory between 2 and 4 , and will shift 
up remaining program memory. If you would like to only clear the program 
memory between two addresses, use the following command: 


2M 2,4 <RETURN> 


All of program memory between addresses 2 and 4 will now contain zeros 
(NOP instructions). It will essentially leave a “hole” in program memory. Use 
the following command to view your changes: 


DI 0 <RETURN> 


Exercise 5: Remove the modifications made to program memory from the object 
code in memory. 


ZP <RETURN> 


This instruction clears the patch table. All of the modifications made to 
SAMPLE.HEX program memory are removed. 


LA TS HET BEAR TGS SBE EE ET SEE 2 A SPO TE STAI SES ESA RP SIE PTT SESSA POSES RSS NEL S A  E BE ST ED PE PE FST I EE AT DESI I SE TST TIED 
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Exit the MPSIM Session 


There are two ways of exiting MPSIM: 


AB <RETURN> 
Q <RETURN> 


Using the AB command causes the old journal file to remain the same. The 
Q command overwrites the old journal file. 


You have now been introduced to some of the most commonly-used func- 
tions in the simulator, and should have an understanding of how to use 
them. If you need any additional information about any of the files that the 
simulator uses or generates, please review the information in Chapter Two. 
Chapter Five provides a list of all the commands that are available in MPSIM, 
complete with a detailed description of their functions and syntax. 


A a SE SEE EA ESE DESI SS BS SSE TS TSA E AOE DEE SEE GTB ETSI IE EE IIE OSTEO OES GOI IIE ISIS MSR DEE EN TSA TE TS EE IE EEE TET AT EEC TEAC 
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Chapter 4. Functional Categories of MPSIM Commands 





Chapter 4 is intended to be used as a quick way to help locate a MPSIM 
command by function. All of the commands presented in this chapter have 
been grouped together according to function instead of alphabetical order. 
Once the desired command is found, it can be looked up in Chapter Five 
"MPSIM Simulator Commands" if a more detailed explanation or example is 
required. All commands have been divided into the following categories: 


¢ Loading and Saving 
¢ Inspecting and Modifying 
- Program Memory 
- File Registers and Pins 
- Timers 
- Display Functions 
- Patch Table 
- Symbol Table 
¢ Executing and Tracing 
¢ Modifying the View Screen 


¢ Miscellaneous Commands 


Loading and Saving 


The following three commands load and save object code and listing files. 


LO filename format Load file filename with format into program 
memory. MPSIM also loads the source file. 


LS filename Load filename into internal symbol table. 


O filename format Write modified object code to filename. 


Before simulation can begin, use LO to load an object file into program 
memory. Immediately after loading the object file, MPSIM tries to load the 
listing file using the same filename and the extension .LST. If MPSIM still 
can’t find the listing file, the source code file cannot be loaded and displayed 
at break points. Instead, MPSIM disassembles the object code and displays 
the disassembled instruction. 
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The object file can be any of two different formats: INHX85 or INHX8M. 


Example: LO SAMPLE.OBJ INHX8M<RETURN> 


After modifications have been made to the program memory, the user may 
wish the save the corrected object code into an external file. Use the O 
command to output the object code. Enter the filename including the 
extension. 


Example: O SAMPLE1.OBJ INHX85<RETURN> 


Inspecting And Modifying 


MPSIM allows user to change the values of any data area or program 
memory any time during the simulation. 


Program Memory 


In the course of testing a program, you may need to modify its instructions. 
Both the following commands do so. 


IA address Display/modify program memory at address using 
symbolic format. 
M address Display/modify program memory at address using 


the current radix format. 


If you use IA, the source code for the address displays, followed by ‘:’ on 
the next line for the new command. The new command must consist of a 
valid mnemonic followed by zero or more operands. Each operand must 
contain a single value or symbol, no expressions will be allowed. MPSIM 
interprets all values based on the current input radix as set with the SR 
command. 


Entering ‘Q’ at the prompt ends the command; entering ‘-’ causes MPSIM 
to go back and inspect/modify the previous address; entering <RETURN> 
leaves the instruction alone and continues to the next address. 


[a rriesiemmetesesnisimuibienisricomacretonceocaemssursemcemmmeeeerseee===>onsmaemmepmndaimin science nian cuiecccaeecncaie eee eee ace Ne al 
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Example: %IA 200 <RETURN> 


0020 0200 0145 LABEL CLRF F5 
;Clear I/O register for port A 


: CLRF 6 


0021 0201 0147 CLRF F7 
;Clear I/O register for port C 


0200 0146 LABEL CLRF 6 
2.) 


After changing the object code, the original source code no longer displays. 
It is replaced by a disassembled source line. 


If you use M, the contents of the address display in the same format as the 
current radix. The prompt ‘:’ immediately follows the data. Place the new 
value after the prompt, using the current radix. 


The ‘-’, ‘Q’ and <RETURN> have the same affect as described above. Two 
additional commands that affect program memory are: 


IN address, instruction Insert instruction at address in symbolic 
format. 


DE address1,address2 Delete program memory from address7 to 
addressz2. 


The IN command places a symbolically formatted opcode at the given 
address, then displaces values that follow address by one location. The new 
command must consist of a valid mnemonic followed by zero or more oper- 
ands. Each operand must contain a single value or symbol, no expressions 
will be allowed. 


The DE command deletes the code within the given boundaries then shifts all 
data in program memory locations greater than the upper boundary down to 
the lower boundary. 


SIRE SATELLITE A SR DSC RII A AME DEBTS ESAT A AO I OS I A EY DEES BPI ST I TELE IEEE ER OPTS ET TE TACTILE EEE TEES ITE EET EEE SE TIE BETES 
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Registers 

Each register can be inspected/modified by using the following commands: 
F register Display/modify contents of file register 

W Display/modify contents of W register 

sc Display/modify processor cycle time 

SE data_area Display/modify any data_area 

RE Reset elapsed time and step count 


Inspect and modify file registers with the F command. The value of the 
register displays followed by the prompt ‘:’. Enter the new value after this 
prompt. 


Example: 
%F 3 


F3=20:21 (The value of F3 has now been changed to 
21.) 


To inspect and modify the W register the W command is used. 
Example: 
%W 
W=44:00 (The value of W has now been changed to 0.) 
Inspect and modify the simulated cycle time with the SC command. 
Example: 
%SC 
2.0:.2 


Display and/or modify the value of any other data area (stack, pins, status 
bits, all registers) with the SE command. 


Example: 
%SE OPT 
OPT=FF: FE 
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Display Functions 


The display functions are provided to print formatted lists of various program 
variables in the command/source area on the screen. 


DR Displays the contents of all registers including 
W, status and the stack. 


DM adadr1,addr2 Displays the code from address1 to address2. 
The code displays only in the current radix, not 
in mnemonics. address? must be less than 
address2 and both must be in the valid range of 
program memory. 


DiI addr1,addr2 Displays the code from address! to address2. 
The code displays in both the current radix and 
mnemonics. address1 must be less then ad- 
dress2 and both must be in the valid range of 
program memory. 


You can terminate the DM and DI commands at any time by pressing any 
key. 


Example: 
SDI 0, 3 
0000 0020 MOVWF 0 The MOVWFE instruction = 2 
0001 0063 CLRF 3 The CLRF instruction = 6 
0002 0080 SUBWF 0,0 The SUBWF instruction = 8 
0003 0069 CLRF 9 The CLRFF instruction = 6 


SDM O, 3 
0000 0020 
0001 0063 
0002 0080 
0003 0069 
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Patch Table 


During the course of simulation, several changes may have been made to 
the object code in order to achieve the desired results. The patch table 
keeps track of all changes made by maintaining the original value of the 
address along with the most recent change. The patch table can then be 
displayed out in symbolic format to aid the user in making changes to the 
source code. The following three commands manipulate the patch-table. 


ZP Clears the patch table and resets it to no patches 
made. All changes previously made to the object 
code remain. 

DP Display all patches in symbolic format. Both the 


Original object code and new code display. 


RP Restores all patches to their original value and 
clears the patch table. 


Clearing Memory and Registers 


Memory and registers can be cleared quickly by using the following com- 


mands. 

ZM adar1,addr2 Zero the program memory from address1 to ad- 
dress2. address1 must less than address2 and both 
must be valid program memory addresses. 

ZR Zero all of the file registers (FO through F31). 

ZT Zero the elapsed time counter. 


Clear any of the other data areas with the SE command. 
Searching Memory 


It is sometimes desirable to search the program memory for specific instruc- 
tions or operands. The following three commands search program memory 
for various patterns and display(?) each line containing that pattern. 


Si address1,address2,instruction 


Search program memory from address1 to address2 for any occurrence of 
instruction. instruction is in mnemonic format. 


SM address1,address2,m 


Search program memory from address? to address2 for any occurrence of 
the value m. Specify the search criteria in the radix mode, not in mnemonics. 


SFaddress1,address2,register 


Search program memory from address1 to address2 for any instruction that 
accesses file register. Specify the search criteria in the radix mode, not in 
mnemonics. 
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Example: 

SI 0, 20, NOP 

0000 0000 LOOP NOP 

0006 0000 NOP 

001E 0000 NOP 

SM 0, 20, O 

0000 0000 

0006 0000 

OO1E 0000 
Symbol Table 
The following commands manipulate the symbol table: 
DS Display symbol table. 
DLsymbol Delete symbol from symbol table. 


GS symbol,value,type Generate symbol with a value of type. type may 


be file, bit(file), label or literal. See the GS com- 
mand description for the exact syntax. 


Example: 
DS 


Symbol 


START 0000 


GS NEWSYM, 


Symbol 


START 0000 


NEWS YM 


Restore 


Value Type 
L 


FF, B 
Value Type 
L 

OOFF B 


The Restore All command, RA, has the combined effect of restoring the 
patch table, clearing the symbol table and removing all break points. 
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Execute and Trace 


The simulator executes in three basic modes, execute until break, single step 
or trace. In either of these modes you can stop execution at any time by 
pressing any key. 


Execution Instructions 


The E command begins execution at the specified address, or at the CPC if 
you don’t specify an address. The loaded program executes until reaching a 
break point or until you press any key. If you wish to slow down execution, 
use the single step instruction, SS. SS executes the single instruction at the 
specified address or at the CPC if you don’t specify an address. 


Tracing Execution 


In the trace mode, all addresses meeting certain conditions display as they 
execute. The conditions may include: 


¢ Agiven instruction within address boundaries. 
¢ Accessing a given register. 


¢ Agiven register containing a value between two limits. The following 
trace parameters maintain trace execution. 


¢ Register number being traced. 

¢ Range of register values. 

¢ Range of addresses to trace. 

The following commands set up and execute the trace mode. 


TC #instructions Trace the next #instructions. |f you omit 
#instructions, execution continues until MPSIM 
encounters a break point or until you press any 


key. 

TA Sets the upper and lower address trace limits to 
the full range of program memory. 

TA addr1,addr2 Sets the lower validation limit for address trace to 
address1 and the upper address validation limit to 
address2. 

TR Sets the address trace to trace any file register. 

TR reg Sets the address trace to trace the file register. 


TRreg,min_val,max_val Sets the address trace to trace the file register 
only if the value of the register is between 
min_value and max_value. 
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DX 


Note: 


Examples: 


Displays the current trace parameters. When in 
trace mode, the location, opcode, mnemonic, 
elapsed time, cycle steps and any changed data 
areas will be displayed when the given conditions 


are met. 
F2 and F3 won't display if changed, however, 
status bits do display. 
%DX 
Address 0000:01FF 
TC 2 
0002 0000 LOOP NOP |} 6.00u 0003 | 
0003 0040 TEST CLRW | 8.00u 0004 | 2Z:1 
STR 4, 0, F 
STR 3 
STA 0, 4 
$DX 
Address 0000:0004 
F3 0000:01FF 
FA4 0000:000F 
STC 40 
0004 0020 CALL START | 10.00u 0005] [005,000] 


Stack contents always display in brackets with the top of the stack to the left. 


aT 
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View Screen 


Break Points 


MPSIM allows the user to set up to 512 break points on any valid address. It 
also allows conditional break points on any of the data areas. When one of 
these break points is encountered, the current address is displayed in 
symbolic format and control is returned to the user. The following commands 


control the break points. 


B address 


B data_area op val 


BC address 

BC data_area 
BC 

C #breakpoints 


DB 


Set break point at address (symbolic address can 
be used). 


Break when data_area matches the condition given 
by the operator (=,>,<,>=,<=,!=) and value. 


Cancel break point at address. 
Cancel break point involving data_area. 
Cancel all break points. 


Continue execution ignoring #breakpoints break 
point occurrences. 


Display all active break points. 


Only one conditional break point is allowed per data area. 


The following commands set up and manipulate the view screen. 


V data_area,radix,#digits 


NV 


This command sets up the view screen. This means 
that the View command defines the variables (and 
respective formats) to constantly display on the 
screen. Once the view screen is set, it remains 
active until either a NOVIEW command or a View 
sets up a new view screen. The format of this 
command is relatively simple. Register or signal s 
displays in radix mode r with n digits. r defaults to 
hexadecimal and n defaults to 1. Ifn is omitted, the 
number of digits is 1. The radix can be binary, octal, 
hexadecimal or decimal. 


This command clears the view screen. The same 
effect can be achieved by redefining the view 
screen. 


SN EAS EASE DS A EN AT GD ITE DS SSSI SN IIS EA I SE DPE RS RE TEL ACI OR ES TSS STIS TL EBS TEER ES TE TE SES TPE D TAPES 
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AD data_area,radix,#digits 


This command adds items to the view screen. If one 
desires to add more display items to the view 
screen, use the Add command. While this 
command’s format is identical to View, it doesn’t 
destroy the current contents of the view screen, but 
simply displays additional items as well as the 
current ones. 


DV data_area This command simply removes display items from 
the view screen while leaving the display formatting 
intact. 


TY data_area,radix,#digits 


This command changes the formatting of the exist- 
ing view screen. s is the signal name (if the desig- 
nated signal isn’t in the view screen, MPSIM gives a 
warning). The radix can be x, 0, dor b and n is the 
number of spaces to reserve for this variable at the 
display time. 


Miscellaneous Commands 


SR radix This command sets the input/output radix to Octal, 
hexadecimal or Decimal. The radix will be used on 
all inputs and outputs with the exception of file 
register numbers and step counts. 


P {541551771...} Choose the appropriate PIC16CXX Microcontroller 
number n. n can be any member of the PIC16CXX 
or PIC16C5X microcontroller family. The default is 
55. 


GE filename This command forces MPSIM to get its command 
stream from an external text file. When end of file is 
reached, the control is returned to the user interface. 
All the incoming commands are parsed by the same 
mechanism as the one supervising the on-line 
interface thus the syntax should follow the guidelines 
of this document. If the specified file is not found, 
the user will be notified. 


Q This command terminates the dialogue. It prints out 
one or two summary messages, removes the journal 
file and exits to the operating system. 


AB This command aborts the dialogue. It prints out one 
or two Summary messages and exits to the operat- 
ing system. 
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ST filename 


CK pin, high, low 


Stimulus command allows the user to introduce an 
event-based stimulus injection into the model. That 
is, the user may want to inject certain values into 
certain pins or registers at some point during the 
simulation. The stimuli are defined in a text file 
whose format is described on pages 12 and 13. 


The Help command lists the syntax and a brief 
summary of each command available in MPSIM. 
There are several screens of information. Press 
SPACEBAR to exit, any other key to display the 
next screen. 


This command allows you to assign a clock to an I/O 
pin. 


DK altfxkey, pin, event 


This command simulates an asynchronous event 
through a function keystroke, and is very useful for 
simulating external interrupts or resets. 


Fil FileNameAddr, PMemAddr, n 


This command injects values into a file register when 
the PC = PMEMAddr. 


RS ene A LR IS PE PSE EE SES ESS EL TE ST TTI BE INE ASN ATE EAE BEB TD TPCT EET TIE TEE A EEC G2 AE OIE SE A EDEL LSS 28 TIE TIE 2 I TTT VES SECT SE LEST TITS EA ESTEE TE EE ONDE ITT 
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The following table lists the commands currently available with MPSIM. The sec- 
tions that follow describe each command in greater detail. This table is also avail- 
able in Appendix E, Quick Reference. 


TABLE 5.1 - MPSIM COMMANDS 


AB Abort session. 


AD data_area,{O|X|B|D},#digits Add data_area to view screen, showing 
data_area in octal, hexadecimal, Binary or 
Decimal radix with #digits. 


B address Set breakpoint at address. 


B data_area {=|>|<]|>=|<=|/=} value. Break when data_area matches the condition 
given by the operator (=,>,<,>=,<=, /=) and value. 


BC [{address| data_area] Clear breakpoint at address or involving 
data_area. If you don’t supply address or 
data_area, Clear all break points. 


C #breakpoints Continue executing, ignoring #breakpoints 
breakpoint occurrences. 


[pin [high, low] | [ - ] ] ] Command allows you to assign a clock to an I/O 
pin, and the number of cycles that it should be held 
high and low. 


Display all active break points. 


address1,address2 Delete code from memory address1 to 
address2. 


address1[,address2] Display program memory from address to 
address2. The code displays in both the current 
radix and mnemonics. If you don’t supply 
addressz2, the I/O lines display at address1. 


[[alt-key [pin, event]]]/[ - ]] | Assign an asynchronous event to an Alt-key. 


symbol Delete symbol from symbol table. 





(Cont.) 
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DM addressil1,address2 






DP 

DR 

DS 

DV data_area 
DW {E£|D} 

DX 


E address 


EE address 
F register 


FI [[file, memory_adadr, 
file_reg [,nJ]/[-]] 


FM addril, addr2, pattern 
GE filename 


GO 


symbol, value, type 


address 


address, instruction 


[time | step] 
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Display the code from addressi1 to address2. 
The code displays only in the current radix. 


Display all patches. 

Display all registers, W register, flags, stack. 
Display symbol table. 

Delete data_area from view screen. 
Enable/Disable watchdog timer. 

Display current trace parameters. 

Execute program from beginning address. If you 
don’t supply address, MPSIM begins executing at 
the current program count. 

Modify data EE memory address on PIC16C84. 


Display/modify contents of file register. 


Insert the next value from file into file_reg when 
the current program counter equals memory_addr. 


Fill memory from addr1 to addr2 with pattern. 
Get MPSIM commands from filename. 


Reset the PIC16/17 Microcontroller and execute 
from start. 


Generate symbol with value and type. 
type can be file, bit(file), label or 
literal. 


Display help screen. 


Display/modify code at address. The code 
displays in both the current radix and mnemonics. 


Insert instruction at address. 
Inject stimulus according to time or step count. 


Load and execute journal file. 


(Cont.) 
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LO filename format Load object file filename with format into 
program memory. Listing file is also loaded at this 
time. 


LS filename Load symbol file filename into internal symboi 
table. 


M address Display/modify code at address. The code 
displays only in the current radix. 


NV Clears view screen. 


O filename format Output modified object code to filename using 
format. 


P {54|55|71...} Choose Microcontroller number. Default is 55. 


Q Quit session. 


| RA Restore all: patch table, symbol table and break 
points. 


Reset elapsed time and step count. 
Restore patches to original instructions. 
Simulates a Power-On Reset. 


Display/modify processor cycle time (the default is 
2 microseconds). 


data_area Display/modify data_area. 


addressl1,address2,register Search code from addressi1 to address2 for 
an instruction with register. Thesearch 
criteria must be in the current radix. 


addressl1,address2?, instruction Search code from address1 to address? for 
an instruction. The search criteria must be in 
mnemonics. 


address1,address2, instruction Search program memory from address1 to 
address? for instruction. The instruction 
must be in the current radix. 


{O| X| D} Set Input/Output radix to Octal, heXadecimal or 
Decimal. 





(Cont.) 
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[address] . Single step execution beginning at address. If 
you don’t supply address, MPSIM executes the 
next sequential instruction. 


filename Load stimulus file filename. 


[address1,address2] Set trace to print only those instructions located 
between addresses addressi1 and addressz2. If 
you don’t supply the addresses, MPSIM assumes 
full memory. 


[ #instruction] Trace the next #instruction instructions & 
display if valid. If you don’t supply 
#instruction, MPSIM traces until encountering 
a break or until you press any key. 


[ filename| PRN] Open/Close trace output file or write trace to 
printer. 


[register] Set trace to print only when register is 
accessed. If you don’t supply register, MPSIM 
assumes any register. 


register,min_value,max_value Set trace to print only when register is 
accessed and its value is between min_value 
and max_value. 


data_area,{O|X|B|D}, #digits Change the radix and/or number of digits for 
data_area onthe view screen. The new 
representation is in octal, hexadecimal, Binary or 
Decimal radix with ¢digits. 


V data_area,{O|X|B|D},#digits Create view screen, showing data_area in 
octal, hexadecimal, zinary or pecimal radix with #digits. 


W Display/modify contents of W register. 


ZM addressl1,address2 Zero program memory from address1 to 
address2. 


Clear patch table. 
Set all registers to 0. 


Zero elapsed time counter to 0. 





Pressing <RETURN> at the % prompt reexecutes the last command entered. 
Thus, you can use commands such as SS more easily. 
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AB - Abort Session 
Syntax 


AB 
Description 


The abort command interrupts the MPSIM session and exits. It prints out 
one or two summary messages, and exits to the operating system. MPSIM 
retains the journal file. 


Examples 


AB<RETURN> MPSIM exits and displays the 
following message: 







Elapsed CPU time: h:mm:ss. 





Defaults 


None. 


Related Commands 


The Q command gives the same result. 


AD - Add Item to View Screen 
Syntax 


AD signal{,radix}{,digits} 
Description 


The Add command adds a signal or register to the view screen. Optionally, 
you may specify a radix different from the default and/or the number of digits. 


While this command’s format is identical to View, it doesn’t destroy the 
current contents of the view screen, but simply displays additional items as 
well as the current ones. 


Sa A A ES AS OSE IS SE SO NT SES PS ESSE SS ES PCS STS ESE SEES OO iS ST 2 TENS PICO AE NT AT 
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Examples 
MPSIMCommand | Resut SCs” 
AD IOA Add Tris A to the screen. 


AD RAO,B Add the RAO pin to the screen display with 
binary radix. 


AD MCLR,4 Add MCLR pin to the screen display with 4 
digits. 


AD F3,B,8 Add the F3 register (status) to the screen 
display with binary radix and 8 digits. 





Defaults 


Digits defaults to 2. The radix ordinarily defaults to hexadecimal, but 
you can change this default with the SR command. 


0 OW xX 
Dm oO © ND 


Related Commands 


The vcommand displays the first signal or register you request. Subsequently, 
you can add display items with AD or delete them with pv. If you use a v 
command afterAD, vreplaces all previous display items on the screen with the 
named signal or register. The Nv command wipes all display items off the 
screen. 


The GE command can load an initialization file that sets up the view screen. 
Thereafter, you can use AD and DV to modify it. 


Note: When referencing registers for the AD instruction use hex notation. For 
example, file register 10 would be written as “OA”. 


Example: 


AD FOA, X, 2 


SS A PR A SSE A GNF ST 2 SA ST ST LSS A A SS SS TE A TT TS ASE SBE FETE SEY ETS LEST SG STO TES 
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B - Set Break Point 
Syntax 


B {address|pin] {operator value} 


Description 


This command sets a break point at the specified address or at the location 
where the specified pin or register matches the condition set by the operator 
and the value. 


You can designate the address either with the explicit numeric location or 


with a symbol. 
The operator can be any or the following: 
= equal 
> greater than 
< less than 
>= greater than or equal 
<= less than or equal 
l= not equal 
Examples 


MPSIMCommand | Result 


B LOOP<RETURN> Set break point at label LOOP. 


B F2 > 80<RETURN> Break if F2 is greater than 80. 





Defaults 
None. 
Related Commands 


BC Clears break points previously set and DB displays them. 


Note: When referencing registers for relational instructions use decimal 
notation. 


A RR A SR I EE EIS FPS SE TS TE IOI SBI SEI IT SES SE SS FEE I TES ESE EPEAT 2S IE ER GES US SS TOE OPEB GDSEI ESTE IETS 2 TEE RSE LIA ET TITEL AIEEE 
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BC - Clear Break Point 
Syntax 


BC {address|data_area} 
Description 


This command deletes a specified break point, or all break points if you don’t 
specify one by address or data area. 


Examples 


MPSIM Command | Result 


BC LOOP Cancel break point at LOOP. 
BC F3 Cancel break point involving the F3 register. 
BC Cancel all break points. 
















Defaults 


None. 


Related Commands 


B sets break points and DB displays them. 


C - Continue Executing 


Syntax 
C {n} 
Description 


This command continues execution from the CPC. If you specify n, MPSIM 
ignores the first n break points encountered. 


Examples 


MPSIMGommand | Resuit_ 


Cc Continue executing, break at the next break 
point. 

Continue executing, skip the first three 
break points found, but break at the fourth. 







Defaults 


n defaults to 0. 
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Related Commands 


B sets the break points, DB displays them and .BC clears break points previously 
set. 


CK - Clock 


Syntax 
CK pin, high-cycles, low-cycles 
Description 


This command allows you to assign a clock to an I/O pin, defining the period 
of the clock by stating the number of cycles that the pin should be high, and 
the number of cycles that it should be low. 


Pin is any valid I/O pin on the selected device 
High-Cycles is the number of T-cycles that the pin should remain high 


Low-Cycles is the number of T-cycles that the pin should remain low 


Examples 


% CK RCO, 5, 4 Assign a clock to RCO with a 9 T-cycle period 
(5 high and 4 low cycles) 


%CK RCO - Cancel clock on RCO 


$CK Display current clock assignment 





Defaults 


None 


Related Commands 


None 


RE TE SR a A NT SISTA ED HP OPC EAR ITE SETS NRE OSE ETN IETS DEPOSI PIE EEE ES A IE ST SAE EPCS IE ESSE GBR ET EE DPE EAE ESE AE SPT EE EE EO RPI TPT IE ET ESET TELL LETT TEND 
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DB - Display All Active Break Points 
Syntax 


DB 
Description 


This command lists all active break points. MPSIM allows only one conditional 
break point per data area. 


Examples 


MPSIMCommand | Resuit_ 


‘Sets a break point at LOOP. 


Sets a break point at the location where 
F2 >80. 


Displays all break point locations via 
messages: 


INFO, Break when (F2 > 0080) 


INFO, Break on address LOOP 





Defaults 
None. 


Related Commands 


B sets the break points, DB displays them and BC clears break points previously 
set. 


DE - Delete Program Memory 
Syntax 


DE addressl address2 
Description 


This command deletes the information stored between addressiand address2, 
inclusively. The DE command deletes memory within the given boundaries then 
shifts those locations in program memory that are greater than the upper bound 
down to the lower bound. 
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Examples 


MPSIM Command Result 


DE 0015 OA10 This command removes the GOTO MAIN 


| statement that causes the application to 
continuously execute. 





Defaults 
None. 
Related Commands 


None. 


DI - Display Program Memory in Symbolic Format 
Syntax 


DI addressl, address2 


Description 


This command displays program memory in symbolic format from address1 to 
address2. addressi1 mustbe less then address2 and both must be in the 
valid range of program memory. Ifno address2, l/Olines display at address1. 


You can terminate DI at any time by pressing any key at the terminal. 


Examples 


MPSIMCommand | Resut_ 


The following messages display: 


0000 0020 MOVWF 0 
0001 0063 CLRF 3 
0002 0080 SUBWF 0, 0 
0003 0069 CLRF 9 





Defaults 
None. 


Related Commands 


The DM command also displays memory between two specified addresses; 
however, DM displays the code in the format specified by the current radix rather 
than in symbolic format. 
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DK - Define Key 


Syntax 

DK {AltFxKey, pin, event} 

Description 
AitFxKey is an integer value between 1 and 12. 
Pin is any valid I/O pin. 
Event is H, L, T or P (high, low, toggle or pulse) 


This command simulates an asynchronous event through an Alt-function 
keystroke and is very useful for simulating external interrupts or resets. 


In addition to the stated syntax, the following sequences perform the indi- 
cated operations. 


DK Displays assignment of all function keys 
DK AItFxKey Displays assignment of specified function key 
DK AItFxKey, - Cancels specified function 


DK - Cancels all assignments 


Examples 


MPSIM Command | Resuit 


DK 1,RBO,L 


When MPSIM is executing, if Alt-F1 is hit, 
RBO will be driven low. 


SDK 12, MCLR, P Define Alt-F12 to provide a one-cycle 
pulse on MCLR. 


SE Now during execution (with MCLR high) 
hitting Alt-F 12 will simulate an external 
reset. 


SDK, 3, RTICC, T Define Alt-F3 to toggle RTCC input. 


Now during execution, every time Alt-F3 
is pressed RTCC input will toggle. 


Disable all assignments. 





Defaults 


None 
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Related Commands 


None 


DL — Delete Symbol from Symbol Table 
Syntax 


DL symbol 
Description 


This command removes the specified symbol from the symbol table. 


Examples 


MPSIMCommand | Resut 


DL MULPLR MPSIM removes “mulpir” from the 
symbol table. To provide to or obtain 
data from this data area, you must now 


use the actual register number, F10. 
The value on the view screen, since it 
reads “MULPLR’” isn’t updated. 





Defaults 


None. 


Related Commands 


GS Creates a symbol and puts it into the symbol table, Ls loads a new symbol 
table, DS displays the current symbol table and RA restores (clears) the 
symbol table. 


DM — Display Program Memory in 
Radix Designated Format 


Syntax 


DM addressl address2 


Description 


This command displays program memory from address1 to address2. 
The data stored displays in the format designated by the current radix 
address1 must belessthan address2 and both mustbe inthe valid range 
for program memory. 


You can terminate DM at any time by pressing any key on the terminal. 
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Examples 


- MPSIM Command 


DM 0, 3 


MPSIM displays the memory between 
locations 0 and 3. The following 








messages display: 
0000 0020 
0001 0063 
0002 0080 


0003 





0069 


Defaults 


None. 


Related Commands 


The DI command also displays memory between two specified addresses; 
however, DI displays the code in symbolic format rather than in the format 
specified by the current radix. 


DP - Display All Patches 
Syntax 


DP 
Description 


This command displays all patches in symbolic format. Both the original 
object code and new object code display. 


Examples 


MPSIMCommand | Result 


Defaults 









None. 


Related Commands > 


The M and IA commands modify the object code; . IN adds commands to 
the object code; DE removes object code; RA and RP restore the patches; 
and zP zeros the patches. oO writes the modified object code. 
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DR - Display All Registers 
Syntax 


DR 
Description 


This command displays the contents of all registers including the W and status 
registers, all flags and the stack. 


Defaults 
None. 


Related Commands 


The DP, DS and Dx commands display other MPSIM data areas and param- 
eters. 


SE sets any data area’s value. w displays and optionally modifies the w register. 


F displays and optionally modifies a register value. 


DS - Display Symbol Table 
Syntax 


DS 
Description 


This command displays the symbol table. 


Examples 


MPSIMCommand | Result 


The following messages display: 


Symbol Value Type 
START 0000 L 





Defaults 


None. 


Related Commands 


GS creates a symbol and puts it into the symbol table, Ls loads a new symbol 
table, DL removes a symbol from the current symbol table and RA restores 
(clears) the symbol table. 





© 1994 Microchip Technology Inc. DS30027H-page 53 


MPSIM USER’S GUIDE 





DV - Delete View Screen Item 
Syntax 


DV data 
Description 


This command deletes a signal or register from the view screen display. 


This command simply removes display items from the view screen while 
leaving the display formatting intact. 


Examples 





DV RTCC Deletes the RTCC from the view screen. 


Defaults 


None. 


Related Commands 


The v command displays the first signal or register you request. Subse- 
quently, you can add display items with AD or delete them with Dv. If you use 
avcommand after Ap, v replaces all previous display items on the screen 
with the named signal or register. The Nv command wipes all display items 
off the screen. 


The GE command can load an initialization file that sets up the view screen. 
Thereafter, you can use AD and Dv to modify it. 


DW - Enable / Disable Watchdog Timer 
Syntax 


DW {E|D} 
Description 


This command enables or disables the watchdog timer, depending or the 
parameter specified. E enables it; D disables it. 
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Examples 


MPSIMCommand | Result 
DW E Enables the watchdog timer. 
DW D Disables the watchdog timer. 


Defaults 









None. 


Related Commands 


RE resets the elapsed time and step count and zT zeros the elapsed time. 


DX - Display Current Trace Parameters 
Syntax 


DX 


Description 


This command displays the current trace parameters. When in trace 
mode, the location, opcode, mnemonic, elapsed time, cycle steps, and any 
changed data areas display when the given conditions are met. 


Examples 








The following message displays: 
Address 0000:01FF 





Defaults 
None. 


Related Commands 


The TA, TC and TR commands set the trace parameters. 
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E - Execute Program 


Syntax 


E {address} 
Description 


This command executes the program from the optionally specified address or 
the PC. 


The E command begins execution at the specified address or at the current 
address if no address is specified. The program continues to execute until either 
reaching a breakpoint or until you press a key. 


Examples 


MPSIM Command 

MPSIM executes SAMPLE.OB4J from the 
label START until reaching a berakpoint 
or until you press any key. 



















E OE 


Defaults 


None. 
Related Commands 


The GO command resets then executes from the start; Ss executes the 
instruction at the CPC or at a specified address. c executes from the CPC to 
the specified breakpoint occurrence. TA traces execution between specified 
addresses, and Tc traces execution from the CPC for a specifies number of 
instructions. 


EE - Modify EE Memory 


Syntax 

EE address 

Description 

Manually Modify EE memory address on the PIC16C84. 
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Examples 
%EE 2 | EEMEMORY(2]:00: 
23 EE memory location 2 now contains value 
Ox23. | 
Defaults 
None. 


F - Display / Modify File Register 
Syntax 


Description 


This command displays and/or modifies the contents of the specified file 
register. The value of the register displays, followed by the prompt ‘:’. Place 
the new value after the prompt. 





Examples 
%F 3 The following message displays: 
F3:20: This shows that the F3 register contains the 
value ‘20.’ 
F3:20:27 The F3 register value changes to ‘21.’ 
Defaults 
None. 


Related Commands 


The SE command can give the same result. DR, TRand ZR display, trace and 
zero a specified register, respectively. Mand IA modify the code at a specified 
address, which can affect the register’s value. 


RS SS TRA 20 RPL ES ES SPE I ES ASE A EE IT SEE IE STEELE EE TE TET ITE OSS TO EE ET ET IGE ETE LE I EE SISSIES RE TESS LEED 
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Fl - File Input 


Syntax 
Fl FileName, PMemAddr, FileReg Addr, [n] 


Description 


This command puts the next value in FileName in FileReg when the PC 
equals PMemAdar. |f nis not specified, when the last value in the file is 
read, the next retrieved value will be the first value in the file. This will 
continue until the command is cancelled. If n is specified then the file will be 
read n times only. 


FileName is any valid DOS file name. The file should be an ASCII file 
and should contain one hex value per line. 


PMemAddr _ is the point in program memory at which value should be 
injected. 


FRegAddr __ File register that receives the value. 


n Number of times to go through the file. 
Fl - Closes file and cancels command. 
Examples 


MPSIM Command [Resut 


% FI ADVals.txt, 0x89, 4{- Whenthe PC = interrupt vector, 
insert the next value in the file into 
the ADRES register. 


Close file and cancel assignment. 





The Fi command is useful when simulating devices such as the PIC16C71 
and PIC16C74. Both of these devices have A/D converters (among other 
peripheral modules). MPSIM does not perform an A/D conversion, although 
the interrupt that can be generated upon its completion is supported in the 
software. The Fl command allows you to inject values into a register when a 
certain point in program memory is reached. For example, if the target 
processor is the PIC16C71, you could set up your source code to branch to 
the interrupt vector at the end of conversion and inject a value into the 
ADRES register during the interrupt service routine (by using the Fl com- 
mand). 


The command could be set up as follows: 
FI ADVALUES.TXT, 0x04 0x09 


When the Program Counter equals the interrupt vector (program memory 
address 0x04), inject the next value in the file (ADVALUES.TXT) into the 
ADRES register (file register address 0x09). 
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org 0x04 
Intvct bcf INTCON, ADIE ;At this point, the next 
movfw ADRES ;value in ADVALUES.TXT will 


;be in the ADRES register 


The format of the ADVALUES . TxT file is one HEX value on each line. For 
example: 


OxAA 

0X55 

OXAA 

0X55 

and so on. 
Defaults 


None. 


Related Commands 


None. 


FM - Fill Memory 
Syntax 


FM addrl, addr2, pattern 
Description 


This command fills unused program memory between addr1 and addr2 with the 
specified HEX pattern. 


Examples 


MPSIMCommands| Result 


FM 0,30,0xFFF Fill unused program memory between 0 and | 
30 with OxFFF. 


Defaults 









None. 


Related Commands 
M. 
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GE - Get Commands from an External File 
Syntax 


GE filename 
Description 


This command reads and performs the MPSIM commands in the named ASCIl 
file. 


This command forces MPSIM to get its command stream from an external 
text file. After reaching the end of file, control returns to the user. Com- 
mands in the text file must conform to the same syntax as commands 
entered on-line. If MPSIM cannot locate the specified file, an error message 
displays. 


Examples 


MPSIM Command | Result 
GE SAMPLE. INI Reads and performs commands in 
the file, SAMPLE.INI. 


Defaults 


None. 









Related Commands 


The v command displays the first signal or register you request. Subsequently, 
you can add display items with AD or delete them with pv. If you use a v 
command afterAD, v replaces all previous display items on the screen with the 
named signal or register. The Nv command wipes all display items off the 
screen. 


The GE command can load an initialization file that sets up the view screen. 
Thereafter, you can use AD and Dv to modify it. 


GO - Reset and Execute 
Syntax 


GO 
Description 


This command performs a Power-On Reset and initializes all registers as 
specified in the microcontroller data sheet. The PIC16/17 Microcontroller then 
executes the loaded object code. 
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Examples 


Defaults 






None. 


Related Commands 


The E command executes from a specified address or the CPC; SS 
executes the instruction at the CPC or at a specified address. C executes 
from the CPC to the specified breakpoint occurrence. TA traces execution 
between specified addresses, and Tc traces execution from the CPC for a 
specifies number of instructions. 


GS - Generate Symbol 
Syntax 


GS symbol, value, type{( (filename) } 
Description 


This command generates the specified symbol with the specified value and 
type. The type can be file, bit, label or literal. If the type is bit, it is a bit in the 
specified file. 


Examples 


Value Type 
0000 L 


GS NEWSYM, FF, B Value Type 
0000 L 
NEWSYM B 





Defaults 
None. 


Related Commands 


DL removes a symbol from the current symbol table, LS loads a new symbol 
table, Ds displays the current symbol table and RA restores (clears) the symbol 
table. 
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H - Help 
Syntax 


Description 


This command displays the Help screen, which lists a brief synopsis and syntax 
for each MPSIM command. 


Examples 


|_MPSIMCommand | Result 





H The Help screen, containing command | 
descriptions and syntax displays. 


Defaults 


None. 


Related Commands 


None. 


lA — Display / Modify Program Memory 
(Symbolic Format) 


Syntax 
IA address 


Description 


This command displays or modifies the program memory at address in 
symbolic format. The source code for the address displays, followed by the 
prompt ‘:’ on the next line for the new command. 


Enter the new command as a mnemonic. It must be syntactically correct. 
Operands may contain only a single value or symbol; expressions are not 
allowed. Enter values in the current radix. 


Entering ‘9’ at the prompt ends the command; entering ‘-’ causes MPSIM to 
go back and inspect and/or modify the previous address; entering < RETURN > 
continues to the next address. 


After changing the object code, MPSIM no longer displays the original source 
code. MPSIM replaces it with a disassembled source line. 
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Examples 


|_MPSIMGommand | Result 


$IA 200<RETURN> The instruction line at address 200 (in the 
current radix) displays: 














0020 0200 0145 LABEL CLRF F5 ; 
Clear I/O register for port A: 





MPSIM changes the instruction as 
specified and displays the next instruction 
line (address 201): 


0021 0201 0147 


MPSIM backs up and displays the modi- 
fied instruction at address 200: 





CLRF F7: 










0200 0146 LABEL CLRF 6: 
MPSIM exits the IA command. 


Defaults 


None. 
Related Commands 


DE, IN, M. 


IN - Insert Instruction 
Syntax 


IN address,instruction 


Description 


This commandinserts instructionat address. The instruction places 
an opcode at address then displaces each program memory value after 
address by one location. instruction must consist of a valid mnemonic 
followed by zero or more operands. Each operand must contain a single value 
or symbol, no expressions are allowed. 


Examples 


IN 200, NOP _ MPSIM inserts a NOP instruction at 
address 200 (in the current radix). 
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Defaults 


None. 


Related Commands 


DE, IA, M. 


IP - Injection Point 


Syntax 
IP [TIME | STEP] 
Description 


Inject stimulus according to time or step count. The "step" heading in the 
stimulus file will always remain "step" regardless of the method selected to 
inject stimulus. 


Examples 


-% IP time Stimulus will now be injected according 
| | to time (integer values only). 


Defaults 









Default is "step" 


Related Commands 


None. 


LJ - Load and Execute Journal File 
Syntax 


LJ 
Description 


This command loads and executes the journal file commands. These com- 
mands are not stored in the journal file recorded from the current session; 
MPSIM enters only the La command. 


When the journal file contains a program execution command, you must press 
a key to stop program execution or wait until a breakpoint break occurs; the 
journal file doesn’t record premature execution breaks or exits. 
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Examples 


MPSIMCommand | Resutt 


% LJ All MPSIM commands entered during the 
previous MPSIM session execute These 
commands are not stored in the journal 

file recorded from the current session. 









Defaults 


The default extension is ‘.JRN’. 


Related Commands 


GE, LJ, LO, ST. 


LO - Load File 
Syntax 


LO filename { format} 
Description 


This command loads the specified file into program memory. If the assembler 
selected is MPALC, MPSIM will assume an .OBJ extension. If the selected 
assembler is MPASM, MPSIM will assume a .HEX extension. After loading the 
HEX file, MPSIM attempts to load the listing file using the same filename and the 
extension “.LST’. If MPSIM cannot find the listing file then all instruction displays 
will be a disassembly. When found, MPSIM uses the listing file for display 
throughout simulation. 


The following is a list of valid formats: 
INHX8M 
INHX8S 


Examples 


MPSIMCommand | __Resuit_ 


% LO SAMPLE The HEX, listing and symbolfile 
are loaded into MPSIM in 


INHX8M format. 


% LO SAMPLE INHX8S The HEX, listing and symbol 
file are loaded into MPSIM in 
INHX8S format. 
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Defaults 
The default extension is ‘.HEX’ and the default format is INHX8M. 
Related Commands 


GE, LJ, LS, ST. 


LS - Load Symbol File 
Syntax 


LS filename 
Description 


This command loads the specified symbol file into the internal symbol table. If 
symbolic debugging, the symbol file produced by the assembler must be loaded 
with the LS command or loaded through the LO command. 


Examples 


MPSIMCommand | Result 
MPSIM reads in the symbol file SAMPLE. | 





Defaults 
The default extension is ‘..SYM’. 
Related Commands 


GS, DL, DS, RA. 


M - Display / Modify Program Memory In Radix 
Designated Format 


Syntax 


M address 


Description 


This command displays and/or modifies program memory at address. The 
contents of the address display in the radix designated format, and are followed 
immediately by a prompt *:’. 


To change the value at address, place a new value after the prompt. Be sure to 
enter that value in the current radix. Entering ‘Q’ at the prompt ends the 
command; entering ‘-’ causes MPSIM to go back and inspect and/or modify 
the previous address; entering <RETURN> continues to the next address. 
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Examples 
% M 0005 MPSIM displays the instruction line at 
address 0005 (as determined by the 
current radix) in the current radix:% SR 
O 
%™M O10 MPSIM sets the radix to octal, then 
displays the instruction line at the label 
MAIN in octal: 
Q MPSIM exits the M command. 
% SR X 
% M 010 MPSIM sets the radix to hexadecimal, 
then displays the instruction line at the 
label MAIN in hexadecimal: 
MPSIM redisplays the instruction line at 
MAIN: 
% SR D 
%M main MPSIM sets the radix to decimal, then 
displays the instruction line at the label 
MAIN in decimal. 
Defaults 
None. 
Related Commands 
TA 


NV - No View Screen 
Syntax 


NV 
Description 


This command deletes or clears all elements from the view screen. 
The same effect can be achieved by redefining the view screen. 
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Examples 
MPSIM Command 


MPSIM removes all items from the view 
screen. 





Defaults 


None. 


Related Commands 


AD, V. 


O - Output Modified Object Code 
Syntax 


O filename [format] 
Description 


This command writes the contents of program memory, including any modifi- 
cations to the specified file in the specified format. The program memory 
contains object code. 


The following is a list of valid formats: 
INHX8M 
INHX16 
INHX8S 


PICICE 
Examples 


MPSIM Command 


% O SAMPLE1.OBJ INHX8M MPSIM writes the object code, as 
modified, to the file 


SAMPLE1.OBJ in the INHX16 
format. 





Defaults 
Default output format is the same as the default input format, INHX8M. 


Related Commands 
None. 
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P - Select Microcontroller 
Syntax 


P [54155171!...] 
Description 


Use this command to select the PIC16CXX Microcontroller you want to 
simulate. 


Examples 
MPSIM Command Result 
$ P [54|55|71|...] MPSIM sets the processor type. 


Defaults 
The simulated microcontroller defaults to 55. 


Related Commands 






None. 

Q - Quit 
Syntax 
Q 


Description 


This command exits from MPSIM and returns PC control to DOS. MPSIM stores 
all MPSIM commands entered during this session in the journal file, MPSIM.JRN. 
The old MPSIM.JRN, if present, is overwritten. 


Examples 


MPSIM Command Result 


MPSIM exits and displays the following 
message: 











Elapsed CPU time: h:mm:ss. 


Defaults 


None. 
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Related Commands 


AB 


RA - Restore All 
Syntax 


RA 
Description 


This command restores the patch table, clears the symbol table of user 
defined symbols and removes all break points. 


Examples 


MPSIMCommand | Result 
% RA MPSIM restores the patch table, clears the 
symbol tables and removes all break points. 


Defaults 






None. 


Related Commands 


RP, DL, BC. 


RE - Reset Elapsed Time and Step Count 
Syntax 


RE 
Description 
This command resets the elapsed time and the step count to zero. 


Examples 


MPSIMCommand|  Resuit 
MPSIM resets the elapsed time and the 
step count to zeros. 


Defaults 






None. 
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Related Commands 


ZT. 


RP - Restore Patches 
Syntax 


RP 
Description 


This command restores all patches to their original value and clears the 
patch table. 


Examples 


_MPSIMCommand | Resutt 
MPSIM restores all patches. 


Defaults 


None. 






Related Commands 


RA 


RS - Reset Chip | 
Syntax 


RS 
Description 


Performs a Power-On Reset and initializes all registers as specified in the 
data sheet of the specified microcontroller. 


Examples 


Defaults 


None. 
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Related Commands 


GO 


SC - Display / Modify Processor Cycle Time 


Syntax 
SC [cyclelength] 
Description 


This command displays and/or modifies the microcontroller’s simulated cycle 
time. 


Examples 


MPSIMCommand | Recut 


% SC MPSIM displays the current cycle in ps: 2.0: 


2.0:.2 The entry ‘.2’ changes the cycle to .2ys, 
or 200 ms. 


% SC 2000.0 The cycle length is changed to 2000.0us or 2.0 ms. 





Defaults 
The simulated cycle time defaults to 2 microseconds. 


Related Commands 


None. 


SE - Display / Modify Data Area 


Syntax 
SE data 
Description 


This command displays and/or modifies any data area. 
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Examples 
MPSIM Command Result 


The following message displays: RAO=1: 





The vaiue of I/O pin RAO changes from 1 to 0. 


Defaults 
None. 


Related Commands 


F, W, ZR. 


SF -Search Program Memory for Register 
Syntax 


SF addressl, address2, register 
Description 


This command searches program memory from address to address2 for 
any instruction that access the specified register. Register may be specified 
in literal, ‘F’ syntax or as a symbol. 


Examples 


SF 0, 22, portb MPSIM search all memory from 0 
through 22 for instructions that reference 


the portb register, then displays the lines 
containing the specified instruction: 


0000 0000 main movf portb,Ww 
0006 0000 movf portb,W 





Defaults 


None. 


Related Commands 


SI, SM. 
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SI - Search Program Memory in Symbolic Format 
Syntax 


SI addressl, address2, instruction 
Description 


This command searches program memory from address7 to address2 for any 
occurrence of instruction. instruction is in symbolic format. Full or partial 
instructions may be specified. 


Examples 


MPSIMCommand | Result 


% SI 0, 20, CLRF MPSIM searches all memory from 0 
through 20 for CLRF instructions, then 
displays the lines containing the specified 
instruction: 


0000 mpy_S cirf H_byte 


0001 clrf L_byte 


MPSIM searches all movwf count 
memory from 0 through 20 for MOVWF 
COUNT instructions, then display the lines 
containing the specified instruction: 


0003 movwf count 





Defauits 


None. 
Related Commands 


SF, SM. 


SM — Search Program Memory in Radix Designated 
Format 


Syntax 
SM addressl, address2, instruction 
Description 


This command searches program memory from address! to address2 for 
instruction. Specify instruction in the format designated by the radix. 
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Examples 


MPSIMCommand | Result 


% SM 0, 30, C08 MPSIM search all memory from 0 through 
20 for the specified instruction, then 
displays, in the current radix, the lines 
containing it: 


0002 moviw 8 













Defaults 


None. 


Related Commands 


SF, SI. 


SR - Set Radix 
Syntax 


SR [O|X|D] 
Description 


This command sets the radix to octal, hexadecimal or decimal. Subse- 
quently, MPSIM expects and uses this radix for all I/O including file register 
numbers and step counts. 


Examples 


The radix becomes octal. 


The radix becomes hexadecimal. 


The radix becomes decimal. 





Defaults 


None. 


Related Commands 


None. 
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SS - Execute A Single Step 
Syntax 


SS [address] 


Description 


This command executes a single step located at address. |f you don’t specify 
address, MPSIM executes the instruction at the CPC. Pressing <RETURN> at 
the % prompt re-executes the previous MPSIM command. Thus, by entering Ss 
once and subsequently pressing simply < RETURN >, you can single step through 
multiple instructions easily. 


Examples 


MPSIM Command | __Result 


% SS O1LFF MPSIM resets the simulator code by 
executing the reset address (PIC16C54 
and PIC16C55). 





Ss MPSIM executes the line of code at the 
PCP. 
SS 20 MPSIM executes the line of code at 
address 20 (in the current radix). 
SS LOOP MPSIM executes the line of code at the 
label LOOP. 
Defaults 
None. 


Related Commands 


None. 


ST - Read Stimulus File 
Syntax 


ST filename 
Description 


This command inserts specified values into specified pins or registers at a 
specified simulation step or time. The specified values, pins/registers and 
steps are defined in a text file called a stimulus file. Stimulus can be injected 
either according to step or time. See instruction ‘IP’ for details. 
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The stimulus file allows you to schedule bit manipulation by forcing MPSIM to 
drive given pins to given values at a specified input step. 


The st command reads the stimulus file into MPSIM. When you execute a 
file with the E command, each time it looks for input, it reads the next step in 
the stimulus file. 


The first line of stimulus file always consists of column headings. It lists first 
the word “STEP,” followed by the pins that are to be manipulated. The data 
below STEP represents the object file’s input request occurrence. The data 
below each pin name is the input value. You may enter comments at the end 
of a line by preceding it with an exclamation mark (!). 


The following example illustrates the stimulus file format: 


STEP RAO RA1 ! These are I/O pin names 
8 1 0 

16 0 1 ! followed by values 

24 1 0 


Other notes on the format of stimulus file: 
¢ the number of spaces separating columns is irrelevant 
¢ the step count must be in decimal 


Examples 


MPSIMCommand | Result 


% ST SAMPLE.STI MPSIM reads the specified stimulus file. 
Upon execution, it will retrieve input as 
designated in this file. 











Defaults 


The default injection point is “step”. The default file extension is *.STI’. 


Related Commands 


IP 


TA - Print Trace Instructions 
Syntax 


TA [addressl, address2)] 
Description 


This command sets the trace to print only those instructions located between 
address1 and address2. |f you don’t specify address1 and address2, MPS|IM 
uses the full memory. 
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Examples 


MPSIM Command 
% TA main, call_m Upon the invocation of the rc command, 


MPSIM will print/display only those 
instructions between main and mpy_S. 





Defaults 
Address range defaults to all of memory. 


Related Commands 


TC, TF, TR 


TC - Trace Instructions 
Syntax 


TC #instructions 
Description 


This command traces the next #instructions instructions, displaying the 
instructions if they are valid. If you don’t supply the #instructions, the 
trace continues indefinitely until encountering a breakpoint or until you press 
any key. 


Examples 





Defaults 


None. 


Related Commands 


TA, TF, TR 
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TF - Open Trace Output File / PRINT Trace 
Syntax 


TF [filename |Prn}j 


Description 


This command opens or closes a file for writing the trace, or prints the trace. If 
you enter PRN as an argument, MPSIM prints the trace to the default printer. If 
you supply filename, MPSIM opens that file, if you don’t, MPSIM closes any 
currently opened output trace file. 


You must use the TF command BEFORE starting the trace: 





Examples 
% TF Close the output trace file. 
% TF PRN Print the trace to the default printer. 
% TF SAMPLE. TRC Open SAMPLE.TRC and write the trace 
to it. 
Defaults 
None. 


Related Commands 
TA, TC, TR 


TR - Trace Register 
Syntax 


TR register [, min_value, max_value} 


Description 


This command sets the file register trace. If you don’t supply any parameters, 
MPSIM traces any file register. If you specify register, it traces that register. If 
you also specify min_value and max_value, it performs the trace only if the value 
of the specified register lies between min_value and max_value. 
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Examples 
| MPSIM Command 


Traces all registers. 
Traces the W register. 


Traces the W register when its value falls 
between 2 and 7 (in the current radix). 





Defaults 


None. 


Related Commands 


TA, TC, TF 


TY - Change View Screen 
Syntax 


TY data_area,{X|O|D|B),#digits 
Description 


This command changes the formatting of existing view screen elements. 
data_area names the pin or register. Ifitisn’tin the view screen, MPSIM gives 
a warning. 


The radix can be hexadecimal, octal, decimal or binary, designated by x, 0, 
Dor B, respectively. 


#digits is the number of spaces to for this variable on the view screen. 


Examples 









RTCC I/O pin displays in binary, using one 
digit. 


MPSIM Command 
% TY RTCC,B,1 








Defaults 


None. 


Related Commands 


AD, NV, V. 
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V - View Screen 
Syntax 


V signal [{,radix [{,digits]j 


Description 


This command creates a new view screen that displays the named signal or 
register. Optionally, you may specify a radix different from the default and/or a 
number of digits. 


Vv sets up the view screen. This means that the View command defines the 
variables (and respective formats) to constantly display on the screen. Once the 
view screen is set, it remains active until either an NV command or a V command 
sets up a new view screen. The format of this command is relatively simple. 
Register or signal s displays in radix mode r with n digits. The radix can be B 
(binary), O (octal), X (hexadecimal) or D (decimal). 


Examples 


MPSIM Command | Result 


% V F3,b,8 A view screen element is created with 
the following format: 


F3: 00000000 


% V RBO aAviewscreen element is 
created with the following format: 


RBO: 00 












Defaults 


The radix ordinarily defaults to hexadecimal, but youcan change this default with 
the SR command. Digits defaults according to the table below: 


TABLE 5.4 RADIX DEFAULT WIDTHS 





Related Commands 


AD, DV, NV, TY. 
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W - Display / Modify the Work Register 
Syntax 


W 
Description 
This command displays and/or modifies the contents of W register. 


Examples 


MPSIM Command | Result 


The value of W is 44 as the following 


message shows. 


Change the value by entering a 
different value after the ‘:’ prompt. 





The W register now has a value of 0. 


Defaults 
None. | 
Related Commands 


None. 


ZM - Zero the Program Memory 
Syntax 


ZM addressl, address2 
Description 


This command zeros the program memory from addressi1 to address2. 
address1mustless than address2 and both must be valid program memory 
addresses. 


Examples 






MPSIM Command 


% 2M 0, IF Program memory from 0 to 1F is zeroed. 





Defaults 


None. 
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Related Commands 


None. 


ZP - Zero the Patch Table 
Syntax 


ZP 
Description 


This command clears the patch table. Clears the patch table and resets it to 
no patches made. Any changes made to the object code are unaffected. 
Thus, the object code cannot be restored to the original. 


Examples 


MPSIMCommand | Result, 
Patch table cleared. 


Defaults 











None. 


Related Commands 


O, RA, RP. 


ZR - Zero the Registers 
Syntax 


ZR 
Description 


This command sets all of the file registers to zero. Care should be taken with this 
instruction since it will zero the lower 8 bits of F2 (PC). An RS command should 
follow the zR command to ensure the PC is set the expected reset value. 


Examples 


MPSIMGommand | ___Result 
All registers are zeroed. 
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Defaults 
None. 


Related Commands 


DR, RS, SE. 


ZT - Zero the Elapsed Time Counter 
Syntax 


ZT 
Description 
This command zeros the elapsed time counter. 


Examples 


MPSIMCommand | ___Resut) 
The elapsed time counter resets to zero. 


Defaults 
None. 


Related Commands 


RE, RS. 


mA a I EE 2 AS PETE ETE SEA PTET RS STS SA SAE TN RE PS A OC SIT ELT FRI LI TT TF EES SST A ESL TE ES SDS IEP TE NPE ETE SI EI I TEA 
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Appendix A. Trouble Shooting Guide 





This Appendix consists of the following sections: 
¢ Solutions to common problems 


¢ The three types of messages generated by MPSIM, grouped by severity 
and their possible causes and solutions. Messages have been divided 
into the following groups: 


¢ Informative Messages 
¢ Warning Messages 


¢ Error Messages 


Solutions to Some Common Problems 


Problem 1: | keep getting strange error messages like “stack 


underflow” or “Illegal Opcode” when single- 
stepping through or executing my code. 


Solution 1: Check to make sure that the processor type you 
selected in MPSIM is the same as the processor 
type you selected when you assembled your 
code. This is especially important when simulat- 
ing the members of the PIC16CXX family since 
the object code for the PIC16CXX family is 
different from the PIC16C5X, and the default 
processor type for the simulator is the 
PIC16C54. 


Problem 2: When | am trying to step through my code, 
MPSIM seems to execute an instruction different 
from the one that is displayed in the command 
area. 


Solution 2: Check to make sure that you loaded your code 
into the simulator in the same format that 
assembled it. For example, if you assembled 
your code and didn't specify an output format, 
you object file will be in INHX8M format. If you 
then load your code into the simulator in 
INHX8S format, the simulator will behave 
strangely. 
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Problem 3: MPSIM does not perform indirect addressing 
correctly. 
Solution 3: Check to make sure that you do not have your 


indirect addr register defined as the label "FO" in 
your source file. There is a symbol-table conflict 
when you define your label as such. Rename 
the "FO" label in your source file to "INDO" or any 


other label. 
Problem 4: The W register does not update on my screen. 
Solution 4: You have redefined W in your source file to be 


equal to zero, and MPSIM now treats W as file 
register 0. Change the label in your source file to 
"Wreg" or something similar. 
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Messages 


Informative Messages 
Address Break After 


Cause: The break point mode has been set to break after the instruction 
has been executed. 


Break at Address 
Cause: A break point has been encountered and execution has stopped. 
Break at Register 


Cause: A break on register condition has been encountered and execu- 
tion has stopped. 


Interrupt at Address 


Cause: Execution has stopped at the indicated address due to a user 
keyboard interrupt. 


Listing File Loaded 
Cause: MPSIM found and read filename.LST 


No Symbols Defined! 

Cause: The user has requested a list of all symbols when no symbols 
had been defined. 

Object Code Written to Disk 

Cause: MPSIM successfully dumped program memory to the named 
object file. 


Original Source Restored 


Cause: MPSIM has restored the source to its original form upon user 
request. 


Out of Memory, Not all Source Lines Loaded 


Cause: MPSIM has exhausted free memory while trying to load the 
listing file. 
Object Code Loaded 


Cause: | MPSIM has found and read filename.OBU. 
Processor Reset 


Cause: MPSIM has reset the processor due to a user request. 
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Symbol Table Loaded 

Cause: MPSIM has found and read filename.SYM. 
Trace File is Closed | 

Cause: MPSIM has successfully closed the trace file. 
Trace File is Open 

Cause: MPSIM has successfully opened the trace file. 
Verbose is OFF 


Cause: Verbose mode is currently OFF, extended user messages will 
not be displayed. 


Verbose is ON 


Cause: Verbose mode is currently ON, extended user messages will be 
displayed. 


Watch Dog Timer Disabled 
Cause: MPSIM will not respond to watchdog timer time-outs. 
Watch Dog Timer Enabled 


Cause: MPSIM will respond to watchdog timer time-outs. 


Warning Messages 


Address2 < Address1 

Cause: When entering a starting and ending address for a command, 
the ending address is greater than the ending address. 

Cure: The starting address must be less than or equal to the ending 
address. 

Arg X out of Range LABEL 

Cause: You have entered a operand that is out of range of the specified 
instruction 

Cure: Review the instruction syntax and reenter. 


Attempt to Read Nonexistent File Register 


Cause: Your object code has attempted to read a file register that does 
not exist in the PIC16/17 Microcontroller you have specified. 


Cure: Set you PIC16/17 Microcontroller type accordingly. 
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Attempt to Write Nonexistent File Register 


Cause: Your object code has attempted to read a file register that does 
not exist in the PIC16/17 Microcontroller you have specified. 
Cure: Set your PIC16/17 Microcontroller type accordingly. 
Bad break Value 
Cause: While defining a register break point, you have specified a break 


value that is either unrecognized in the default radix or is out of 
range for the file register. 


Cure: Ensure the value is valid in the current radix and not out of range 
of the file register. 

Bad Count 

Cause: You have entered a break count that is unrecognized in the 
current radix. 

Cure: Ensure that the value is correct in the current radix. 

Bad Cycle Length 

Cause: You have entered a cycle length that is invalid or unrecogniz- 
able. 

Cure: Reenter the cycle length. 

Bad End Address 

Cause: You have entered an ending address that is out of memory 


bounds or unrecognizable in the current radix. | 
Cure: Ensure that the value is valid in the current radix and reenter. 


Bad Filename 


Cause: The file name you entered was not recognizable as a DOS file 
name. 

Cure: Ensure the file name conforms to DOS naming standards. 

Bad Max. Value 

Cause: This maximum value you entered is not recognizable in the 
current radix. 

Cure: Ensure the value is valid in the current radix and reenter. 

Bad Min. Value 

Cause: This minimum value you entered is not recognizable in the 
current radix. 

Cure: Ensure the value is valid in the current radix and reenter. 
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Bad Opcode 

Cause: While attempting to search program memory for a specified 
opcode, the opcode you entered is unrecognizable in the current 
radix. 

Cure: Ensure the opcode is valid in the current radix and reenter. 

Bad Option 

Cause: — The option you supplied to the V command was not valid. 

Cure: Valid options are on and off. Use on of the valid options. 


Bad Signal Value 


Cause: While attempting to modify an I/O pin’s value, you have entered 
a value that is unrecognizable in the current radix. 

Cure: Reenter the value ensuring it is valid in the current radix. 

Bad Value 

Cause: You have entered a value that is out of range of the file register 
or unrecognized in the current radix. 

Cure: Ensure the value is valid in the current radix and in range for the 
file register. 

Bad Width 

Cause: The number you specified as the width of a view screen element 


was not recognized 
Cure: Ensure the width is a valid number in the current radix. 
Can only Break on File Registers or Addresses 
Cause: You have attempted to set a break point on an I/O pin 
Cure: Break points on I/O pins are disallowed. 
Cannot Add Symbol to Symbol Table 


Cause: Due to memory constraints, MPSIM cannot add the specified 
symbol to the symbol table. 


Cure: Increase the amount of free memory before entering MPSIM. 


Cannot Find Command File 


Cause: MPSIM cannot find the command file you specified. 
Cure: Ensure that the file is present in the path that you specified in the 
command. 
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Cannot Find Command File (MPSIM.jrn) 
Cause: MPSIM cannot find the old journal file. 


Cure: If MPSIM.jrn was not present in the current directory, this 
message is informational only. If the file is present, this may 
signal more serious errors with your disk. 


Cannot Find List File 


Cause: MPSIM cannot find the list file with the same name as the object 
file plus the .LST extension. 


Cure: Ensure you have a list file in the same directory as the object file 
you specified. 


Cannot Find Symbol File 


Cause: MPSIM cannot find the symbol file with the same name as the 
object file plus the .SYM extension. 


Cure: Ensure you have a symbol file in the same directory as the 
object file you specified. 


Cannot Open Trace File 


Cause: MPSIM cannot open the file you specified. This may be caused 
by any number of DOS errors. 


Cure: Ensure that the file you specified doesn’t exist and is read-only, 
or you have exhausted the number of DOS file handles. 


Cannot Parse Filename 


Cause: The file name you entered was not recognizable as a DOS file 
name. 
Cure: Ensure the file name conforms to DOS naming standards. 


Cannot Search for an IO Pin or Status Bit 


Cause: You have attempted to search program memory for an instruc- 
tion modifying an 1/O pin or a status bit. 


Cure: This operation is not supported. 

Cannot Trace an IO Pin or Status Bit 

Cause: You have attempted to set a trace on an //O pin or Status Bit 
Cure: This operation is not supported. 

File Symbol does not Match Page at PC=XXX 


Cause: MPSIM has detected a page mismatch between the file symbol 
and the page select bits in the FSR. 


Cure: This is a software error, your code needs to be fixed. 
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Invalid Filename 


Cause: The file name you entered was not recognizable as a DOS file 
name. 
Cure: Ensure the file name conforms to DOS naming standards. 


Illegal Number of Arguments 


Cause: You have entered the wrong number of arguments for the 
command 
Cure: Supply all required arguments for the command. 
Illegal Radix 
Cause: You have given a radix modifier that is not recognized. 
Cure: aoe radix modifiers are X, D, O and B. Use one of the valid 
pes. 


Invalid Object File 


Cause: The object file MPSIM is trying to load is not valid for the format 
you specified. 


Cure: Ensure that the file is a valid object file in the format you speci- 
fied. 


Missing Instruction 


Cause: You have told MPSIM to assemble an instruction, but did not 
supply the instruction 


Cure: Reenter the command with the desired instruction. 


No Breaks Found Involving 


Cause: While trying to delete a register break point, you have specified a 
file register that has no associated break point. 

Cure: Ensure that a break point for the specified file register has been 
defined via the DB command. 

No Object Code Loaded 

Cause: MPSIM cannot open the object file and as a result cannot load 


the object code. 


Cure: Ensure that the file name you specified is present in the directory 
you specified. 
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Opcode can only be used in PIC16C55/57 Mode 


Cause: MPSIM has tried to execute an instruction that is valid only for 
the PIC16C55 or PIC16C57. Most likely a TRIS 7 instruction. 

Cure: Your Microcontroller type is not set properly. Refer to the P 
command. 

Out of Memory 

Cause: While defining a register break point, MPSIM has exhausted free 
memory. 

Cure: Increase the amount of free memory before entering MPSIM or 
rename the list file so that MPSIM cannot find it. 

Stack Overflow 

Cause: You have executed one too many RETLW instructions for the 
contents of the Microcontroller stack. 

Cure: This is a software error, your code needs to be fixed. 

Stack Underflow 

Cause: You have executed one too many CALL instructions for the size 


of the Microcontroller stack. 
Cure: This is a software error, your code needs to be fixed. 


Start Address Exceeds End Address 


Cause: When entering a starting and ending address for a command, 
the ending address is greater than the ending address. 

Cure: The starting address must be less than or equal to the ending 
address. 


Symbol Already Exists 
Cause: You have attempted to define a symbol that already exists. 
Cure: Use a different symbol name. 


Too Many Arguments 


Cause: You have entered too many arguments for the command. 
Cure: Review the common syntax. 

Unable to Open Object File 

Cause: MPSIM cannot open the object file specified. 

Cure: Ensure that the file is present in the directory you specified. 
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Undefined Symbol 
Cause: You have attempted to delete a nonexistent symbol! 
Cure: Ensure that the symbol is defined. Symbols are case sensitive. 


If you used the case insensitivity switch in the assembler, all 
symbols have been mapped to uppercase. 


Uninitialized Memory Location Executed 


Cause: MPSIM has attempted to execute a memory location that does 
not have any object code loaded. 


Cure: Ensure that there is object code loaded and your program is not 
running amuck. 


Unknown Break Mode 


Cause: You have specified a break mode that is unrecognized to MP- 
SIM. 
Cure: Valid break modes are before and after. Use one of the valid 


break modes. 


Unknown File Format 


Cause: MPSIM has tried to read in an object file that is does not recog- 
nize. 
Cure: Ensure that the file you specified is a valid object file in the 


format you specified. 


Unknown Instruction XXX 


Cause: You have toid MPSIM to assembie an instruction which is not a 
valid PIC16C5X instruction. 

Cure: Reenter the instruction in valid PIC16C5X mnemonics. 

Unknown Opcode XXX 

Cause: There is an invalid opcode in your object file. 

Cure: Ensure that you have loaded your object file in the correct 


format. Default is INHX16. 


Unknown Operator 


Cause: While defining a register break point, you have used an unrecog- 
nized logical operator. 

Cure: Valid operators are <, >, <=, >=, =, !=. Use one of the valid 
operators. 


er SPR SE PP EMT PSEA BES SE TO EDA EIT EST SE IESE TD SE OI PES ASOT SAE A TE ES 
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Unknown Radix 


Cause: You have attempted to modify the default radix to a value that is 
unrecognized by MPSIM. 
Cure: Valid radix values are X. D and O. Use one of the valid values. 


Unknown Symbol Type 


Cause: While attempting to define a new symbol, you have entered a 
symbol type that is unrecognized by MPSIM. 


Cure: Valid symbol types are F, L, K and B. Use one of the valid 
symbol types. 


Use SE Command to Modify IO Pins 


Cause: You have attempted to use the F command to modify an 1/O pin 
Cure: Use the SE command. 

Value Out of Range 

Cause: You have specified a value that is out of range or unrecognized 


in the current radix. 


Cure: Ensure that the value is valid in the current radix and valid for the 
Current operation. 


View Item not Found 


Cause: You have attempted to delete or modify a nonexistent view 
screen element 


Cure: Ensure that the element is present on the view screen. View 
screen elements are case-sensitive. 


ViewScreen is Full 


Cause: You have attempted to add an element to the view screen when 
there is no more room on the screen. 

Cure: Since the view screen is static in this version, there is no work- 
around. 

WDT Time-out 

Cause: The watchdog timer has timed out. 

Cure: Ensure the settings for the WDT are correct and your software 


resets the WDT appropriately. 
XXX is not an IO Pin 


Cause: You have tried to use the SE command to modify a label that is 
not an I/O pin. 

Cure: Use the F command to modify file registers, status bits and the 
stack. 
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Error Messages 

Bad Stimulus (Line X) 

Cause: MPSIM has found a stimulus value other that zero or one. 
Cure: All pin stimuli must be either zero or one. 

Cannot Delete Old Journal File 

Cause: The file MPSIM.JRN has been read protected. 


Cure: If you intended for the file to be read protected then do not worry 
about this error otherwise read enable the file. 


Cannot Find Heading Line in Stimulus File 

Cause: MPSIM cannot find the heading line in the stimulus file. 

Cure: Ensure that there is a line in the file which begins with STEP. 
Cannot Map Stimulus, Symbol Conflict XXX 

Cause: MPSIM has encountered two column headings that are identical. 
‘Cure: Ensure your column headings are correct. 

Cannot Open File for Input XXX 

Cause: MPSIM cannot open the specified file for reading. 

Cure: Either the file does not exist or the file is read-only. 


Cannot Open Journal File 


Cause: MPSIM cannot open the oid journal file. 
Cure: The file MPSIM.JRN has been read protected, change the DOS 
attribute. 


Cannot Update Journal File 


Cause: MPSIM cannot update the journal file with the new commands 
for this session. 
Cure: Either the old MPSIM.JRN cannot be deleted or the new journal 


file does not exist. Contact your local FAE. 
Duplicate Symbol in Symbol File 


Cause: MPSIM has encountered a symbol in the symbol file that has 
already been defined. 


Cure: Delete the duplicate reference. If MPSIM finds this error it will 
not continue to read the symbol file. 


ae pe SPE EIT SEL AS PLE DRT LE STII A SCE RES ESS IE DST SG OY POISE FETE SESE EE ATE TS AE ETE SAIS RE PEEP I EEE ETE IE TIT IEEE TI ANE ELE SEES 
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First Heading in Stimulus File MUST be STEP 
Cause: The line that MPSIM interpreted as the heading line did not begin 


with STEP. 

Cure: Make sure all comment lines begin with ‘ and the heading line 
begins with STEP. 

Out of Memory, Cannot Create Event Calendar 

Cause: MPSIM exhausted free memory while trying to create the event 
calendar. 

Cure: Increase the amount of free memory before invoking MPSIM. 


Out of Memory, Cannot Create Event (Line X) 

Cause: MPSIM exhausted free memory while trying to create an event. 
Cure: Increase the amount of free memory before invoking MPSIM. 
Out of Memory During Build of Break 


Cause: MPSIM exhausted free memory while trying to define a file 
register break point. 


Cure: Increase the amount of free memory before invoking MPSIM. 


Stimulus Data does not Match Headings (Line X) 


Cause: MPSIM has found a line that has too few or too many data points 
to match the column headings. 

Cure: Ensure each data line has one data point for each column 
heading. 


Symbol File does not Match Object File 


Cause: You have tried to load a symbol file that was not generated for 
the current object file. 


Cure: If you intended to load the symbol file, the embedded file name 
must match the file name of the symbol file. 


Symbol File is Corrupt 


Cause: MPSIM has encountered some unexpected formatting in the 
symbol file. 
Cure: Regenerate the symbol file. 


Symbol File Sync Error 


Cause: MPSIM has gotten lost while trying to parse the symbol file. 
Most likely the symbol file is corrupt. 


Cure: Regenerated the symbol file. 
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Too Many Headings in Stimulus File (MAX=40) 


Cause: The stimulus file has a limit of 40 headings, enough for each 1/O 
pin. 
Cure: If there is a need for more headings, contact your local FAE. 


Unknown Command 

Cause: MPSIM does not recognize the command you entered. 
Cure: Refer to the command summary for valid commands. 
Unexpected EOF in Stimulus File 


Cause: While reading the stimulus file, MPSIM encountered a line that 
did not have the proper number of data points. 


Cure: Ensure that all data lines have the correct number of data points 


Unknown File Register X | 


Cause: MPSIM does not recognize the file register as an argument to 
the instruction. 

Cure: Reenter the mnemonic with a valid file register. 

Unknown Option X 

Cause: MPSIM does not recognize the command line option X. 

Cure: Refer to the section on command line arguments. 

Unknown Opcode (X) | 

Cause: MPSIM tried to execute an opcode that is not a valid PIC16C5X 
opcode. 

Cure: Ensure you loaded the object file in the correct format. INHX16 


and INHX8M have different byte orders. 


Se AE I TADS EE EN EEN TS TA SE SE TE TA TER eS ST TS SE a TIS 2S EEG Tf AEST EES IE EA I AEE DE I EC CS BT TTT IT ERE ETS I TTT EE IT LTS TTI 
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MPSIM.INI 


SR X 


MPREG.H 


LIST L=OFF 


pK KEKEKKKEKEKKEKEKEKEK KKK K PIC16C5X Header 
KHRKKKKEKKKEKKEKEKREKKKKKKKEK 


° 
4 


e 
, 


PICC54 equ 1FFH ; Define Reset Vectors 
PICC55 equ 1FFH 

PICC56 equ 3FFH 

PICC57 equ 7FFH 

PICC71 equ OH 

RTCC equ 1h 

PC equ 2h 

STATUS equ 3h ; F3 Reg is STATUS Reg. 
FSR equ 4h 

PORT_A equ 5h 

PORT_B equ 6h ; I/O Port Assignments 
PORT_C equ 7h 
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ADRES 
ADCONO 
ADCON1 
PCLATH 
INTCON 
TRISA 
TRISB 


° 
, 


equ 
equ 
equ 
equ 
equ 
equ 
equ 
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9h 

8h 

88h 
OAH 
OBH 
85H 
86H 


;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 


Specia 
Specia 
Specia 
Specia 
Specia 
Specia 
Specia 


l-purpose 


l-purpose 


l-purpose 
l-purpose 
l-purpose 
1-purpose 
l1-purpose 





registers 
registers 
registers 
registers 
registers 
registers 
registers 


; KREKKKKEKKKKEKKEKREKEKEKKEKEEEEEEKKEKEERKEEKREKKKEEEKKKEKEKKEKEREREKEKKKKKKKKKKKKKKKKEKSE 


CARRY 
c 
DCARRY 
DC 
Z_bit 
Z 
P_DOWN 
PD 
T_OUT 
TO 
PAO 
PAI 
PA2 
RPO 
RP1 
IRP 
GIE 
ADIE 
RTIE 
INTE 
RBIE 
RTIF 
INTF 
RBIF 
ADCS1 
ADCSO 
CHS1 
CHSO 


equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 


Oh 
Oh 
1h 
1h 
2h 
2h 
3h 
3h 
4h 
4h 
5h 
6h 
7h 


5h 
6h 
7h 
7h 
6h 
5h 
4h 
3h 
2h 
1h 
0 

7h 
6h 
4h 
3h 


;16C5X 
+716C5X 
;16C5X 


;16C71 
7;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 
;16C71 


; STATUS REG. Bits 
; Carry Bit is Bit.0 of F3 


> Bit 


Status 
Status 
Status 


Status 
Status 
Status 
INTCON 
INTCON 
INTCON 
INTCON 
INTCON 
INTCON 
INTCON 
INTCON 
ADCNO 

ADCNO 

ADCNO 

ADCNO 


2 of F3 


bits 
bits 
bits 


bits 
bits 
bits 
register 
register 
register 
register 
register 
register 
register 
register 
register 
register 
register 
register 


is Zero Bit 


bits 
bits 
bits 
bits 
bits 
bits 
bits 
bits 
bits 
bits 
bits 
bits 


SN PI LT I ESS ET SS ES PSE PS I SEO BE SP EIT FS So TE TD 
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GO equ 2h ;16C71 ADCNO register bits 
ADIF equ lh ;16C71 ADCNO register bits 
ADON equ 0 ;16C71 ADCNO register bits 
PCFG1 equ lh ;16C71 ADCN1 register bits 
PCFGO equ 0 ;i16C71 ADCN1 register bits 
Same equ lh 
LSB equ Oh 
MSB equ Th 
TRUE equ lh 
YES equ lh 
FALSE equ Oh 
NO equ Oh 


; 
gp RRR KEKKEEKEKEKEKEKKEKEEKE KEKE KEEKERKE KEKE KEKE KER KEKE KEKEKRKEKEEEKEEKEKRKEKEKEKEKEKKKKKK 


LIST L=ON 
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gE KEKEEKERERKEKREREREKEEEEKEKEKERKEKEEKREKREKKEEKREEEKEEEEKEKEKEEKEKEKEKKKEKKKEKK 


; SAMPLE .ASM 
; 8x8 Software Multiplier 


pRRREKEEKKEEKRKEEEKEKEEKEKKEKEKEKEKREKEEKRERKEEKEEKEKREKREKEREKEEKEEEKEKREKEKEKEKEKEKEKKKKKKEKK 


; The 16 bit result is stored in 2 bytes 


; Before calling the subroutine “ mpy “, the multiplier should 
; be loaded in location “ mulplr “, and the multiplicand in 

; “ mulecnd “ . The 16 bit result is stored in locations 

; H_byte & L_byte. 


; Performance 

; Program Memory : 15 locations 
; # of cycles > 71 

; Scratch RAM : 0 locations 


; This routine is optimized for code efficiency ( looped code ) 


; For time efficiency code refer to “mult8x8F.asm” ( straight line 
code ) 


PRR KEKKEKEKEKEKKEKEEKEKEKEKREKREKREKKEEKREKREKEKRKEKEKREKEKREKKEKEEKKEREKEKRKEEKEKEEKEKEKKEKKEKKKKK 


° 
tf 


mulcnd equ 09 ; 8 bit multiplicand 
mulplr equ 10 ; 8 bit multiplier 
H_ byte equ 12 ; High byte of the 16 bit result 
L_byte equ 13 ; Low byte of the 16 bit result 
count equ 14 ; loop counter 
portb equ 06 ; I/O register F6 
include ‘“mpreg.h” 
KRHEKKEKEKKEKEKEKEEKKKEKEKKKEKKKKKKKKKKK Begin Multiplier Routine 


mpy_S clrf H_byte 
clrf L_byte 
movilw 8 
movwf count 


movft mulcnd,w 

bcf STATUS, CARRY ; Clear the carry bit in the status 
Reg. 
loop rrf mulplr 


btfsc STATUS, CARRY 

addwf H_byte,Same 

rrf H_ byte, Same 
ST Ta ae a La a aS 


DS30027H - page 102 © 1994 Microchip Technology Inc. 


Appendix B: File Listings 





Trt L_byte,Same 
decfsz count 

goto loop 

retiw 0 


; 
PRAKKEKKEKEKEKEKEKKEKEKEKE EKER EKKEKKEKE EE KEKKEKEKEKKKKEKKEKEKKEKEKRKEKEKEEKEKEEKEEEEKKKKKKKEKKKK 
. Test Program 


PRAKKKKKEREKKEKEKEKEKEKEKEEKKEKEKEKREKKEKKEKEKEKEEKEKKRKEKEKKEKKEKEKKEEKKEKEKEKEKRKEKEKKEKEKEEKKKKKKK 


start clrw 
option 

main movf portb,w 
movwt mulplr ; multiplier (in mulplr) = 05 
movf portb,w 


movwf mulcnd 


call_m call mpy_S ; The result is in locations F12 & F13 
; H_byte & L_byte 


goto main 

org O1FFh 

goto start 
END 


RR nS SFR FS PS NP SPS SS A TE SE TUE 725 9 EI BT SE PCS ST TT ST SE EES 
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SAMPLE. INI 


LO SAMPLE 
ST SAMPLE 
SR X 

ZP 

ZR 

2T 

RE 


NV 

AD mulcnd 
AD mulpIlr 
AD H_byte 
AD L_byte 
AD count 
AD portb 
AD RB7,B,1 
AD RB6,B,1 
AD RB5,B,1 
AD RB4,B,1 
AD RB3,B,1 
AD RB2,B,1 
AD RB1,B,1 
AD RBO,B,1 
RS 


CR La RES LSE SAT DE SDTV ETT MT TTS ESSA ESS SERS AE PS EDAESA ES OEE TSTE§ PAIS OTD TET DEE ELEC ETP LETTE ILE EEL I SI PAPE SIT EE SEE PD EEE IE I TE SEE SR AGEL TEI STORIE ERT CERIO TEE TNT LET I ET ENE TLR LESTE TD 
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SAMPLE.STI 


! Stimulus file for SAMPLE.ASM 


STEP RB7 RB6 RB5 RB4 RB3 RB2 RB1 RBO ! PortB Pins 
5 0 0 0 0 1 0 0 Td OS 
7 0 0 0 0 0 1 0 1 
84 0 0 0 0 1 0 1 O ! 10 x 5 
86 0 0 0 0 0 1 0 1 
163 0 0 0 1 1 0 1 TP Mere 3 
165 0 0 0 0 0 0 1 1 
242 0 0 0 1 0 0 0 i Pee ae 6 Se may 
244 0 0 0 0 0 ul 1 a 
321 0 1 0 0 0 0 0 O ! 64 x 63 
323 0 0 1 1 1 1 1 1 


AT A ITO PINT ILI TA Sh EIT SI TE ATE IE AT EDIE IEEE ELIE PES EET CRG, EEE SSL TTI OT IT IME, CEE TTL AT AEE LITE RIEL STEADY ILE 3 SETI AL RE A TOD CARE TEL AE ITE LE EE IOS EE ES TOIT IPA ELLE OA SE EE EE POOL INE ELE SEL TEDDIES 
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SE I TE SB TET IF EEE ST TE SEI EES TINE ETS STR I EE TS FA EE TT I IEE EE TE SI ITE ETE ETC ED LD SE TSS STE 
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Keeping Current with Microchip Systems 


Highlights 


Microchip Technology endeavors at all times to provide the best service 
and responsiveness possible to it users. The Microchip Technology 
Systems BBS is one mechanism to facilitate this process. 


The BBS is supported as a service to its customers. This is where all of 
the most recent information regarding systems products can be found. The 
BBS is monitored several times a week for questions. Truly urgent issues 
should not be left with the BBS, but referred to your local distributor, or 
Microchip sales office. 


The BBS is an evolving product. Details of its operation will not be found 
here. This chapter provides a brief discussion of the general services 
available. 


This chapter also describes the Microchip Systems software numbering 
scheme. 


The points that will be highlighted in this chapter are: 
. Access to the BBS 

¢ Special Interest Groups 

. Files 

° Mail 

. Software Releases 


Systems Information and Upgrade Hot Line 


The Systems Information And Upgrade Line provides system users a 
listing of the latest versions of all of Microchip’s development systems 
software products. Plus, this line provides information on how customers 
can receive any currently available upgrade kits. The Hot Line Numbers 
are: 1-800-755-2345 for U.S. and most of Canada, and 1-602-786-7302 
for the rest of the world. 


These phone numbers are also listed on the “Important Information” sheet 
that is shipped with all development systems. The hot line message is 
updated whenever a new software version is added to the Microchip BBS, 
or when a new upgrade kit becomes available. 
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Bulletin Board Access 


Access to the bulletin board is 24 hours per day, barring technical or 
mechanical difficulties. Access is gained by calling your local 
CompuServe® access number. Your modem should be set to 8-bits, No 
parity, 1 stop bit (8-1-N). The service supports baud rates from 300 to 9600 
baud. To access the BBS, follow these steps: 


1. Dial your local CompuServe access number. 

2. Press <ret> and a garbage string will appear. 
3. Enter +<ret> and Host Name: will appear. 
4 


Enter mchipbbs<ret> and you will be connected to the Microchip 
BBS. 


There is no charge for connecting to the BBS. There is no charge to dial 
the CompuServe access number. You do not need to be a CompuServe 

member to take advantage of this connection (you never actually log in to 

CompuServe). 


Bulletin Board Usage 


The bulletin board is a multifaceted tool. It can provide you with informa- 
tion on a number of different topics. 


* Special Interest Groups 


° Files 
° Mail 
° Bug Lists 


° Technical Assistance 


Special Interest Groups 


Special Interest Groups, or SIGs as they are commonly referred to, provide 
you with the opportunity to discuss issues and topics of interest with others 
that share your interest or questions. They may be able to provide you 
with information not available by any other method because of the broad 
background of the PIC16/17 user community. 


There are SIGs for most Microchip systems, including: 
« PICMASTER 


° MPASM 
° Utilities 
¢ Bugs 


These groups are monitored by the Microchip staff. 
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Files 


The Microchip BBS is used regularly to distribute technical information, 
Application Notes’ source code, errata sheets, bug reports, and interim 
patches for Microchip systems software products. Users can contribute 
files for distribution on the BBS. These files will be monitored, scanned 
and approved or disapproved by the moderator of the SIG to which the file 
is submitted. No executable files are accepted from the user community in 
general to limit the spread of computer viruses. 


Mail 


The BBS can be used to distribute mail to other users of the service. This 
is one way to get answers to your questions and problems from the Micro- 
chip staff, as well as keeping in touch with fellow Microchip users world- 
wide. 


Consider mailing the moderator of your SIG, or the SYSOP, if you have 
ideas or questions about Microchip products, or the operation of the BBS. 
Be aware, though, that the SIGs are moderated only about once per day. 
Truly urgent questions should be referred to your local distributor, sales 
representative, or FAE. They are your first line of defense. 


Software Revisions 


Software products released by Microchip are referred to by version num- 
bers. Version numbers use the form: 


XX.yy.zz <status> 


Where xx is the major release number, yy is the minor number, and Zz is 
the intermediate number. The status field displays one of the following 


categories: 

° Alpha 

. Intermediate 
. Beta 


° Released 


Production releases are numbered with major, and minor version numbers 
like: 


3.04 Released 


Alpha, Beta and Intermediate releases are numbered with the major, minor 
and intermediate numbers: 


3.04.01 Alpha 
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Alpha Release 


Alpha designated software is engineering software that has not been 
submitted to any quality assurance testing. In general, this grade of 
software is intended for software development team access only, but may 
be sent to selected individuals for conceptual evaluation. Once Alpha 
grade software has passed quality assurance testing, it may be upgraded 
to Beta or Intermediate status. 


Intermediate Release 


Intermediate released software represents changes to a releasd software 
system and is designated as such by adding an intermediate number to the 
version number. Intermediate changes are represented by: 


¢ Bug Fixes 
* Special Releases 
¢ Feature Experiments 


Intermediate released software does not represent our most tested and 
stable software. Typically, it will not have been subject to a thorough and 
rigorous test suite, unlike production released versions. Therefore, users 
should use these versions with care, and only in cases where the features 
provided by an intermediate release are required. 


Intermediate releases are primarily available through the BBS. 
Beta Release 


Preproduction software is designated as Beta. Beta software is sent to 
Applications Engineers and Consultants, FAEs, and select customers. The 
Beta Test period is limited to a few weeks. Software that passes Beta 
‘testing without having significant flaws, will be production released. 

Flawed software will be evaluated, repaired, and updated with a new 
revision number for a subsequent Beta trial. 


Production Release 


Production released software is software shipped with tool products. 
Example products are PRO MATE™, PICSTART™, and PICMASTER™., 
The Major number is advanced when significant feature enhancements are 
made to the product. The minor version number is advanced for mainte- 
nance fixes and minor enhancements. Production released software 
reresents Microchip’s most stable and thoroughly tested software. 


There will always be a period of time when the Production Released 
software is not reflected by products being shipped until stocks are rotated. 
You should always check the BBS for the current production release. 
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INHX8M INHX8S 


AR :(colon) AR (colon) 


2 Hex digits 2 Hex digits 2 Hex digits 
4 Hex digits 2 Hex digits 4 Hex digits 
2 Hex digits 2 Hex digits 2 Hex digits 


HIGH BYTE 2 Hex digits LOW or HIGH 1 Hex digit LOW BYTE 1 Hex digit 
BYTE 


LOW BYTE 2 Hex digits | | CHECK SUM 2 Hex digits |° | HIGH BYTE 1 Hex digit 
CHECK SUM 2 Hex digits CHECK SUM 2 Hex digits 


Figure D.1a - INHX8S and INHX8M File Formats 


10 }0000)| 00 
10 }0010; 00 
10 |0020) 00 
10 |0030)] 00 
10 }0040/ 00 








Figure D.1b - INHX8M File Formats 


A A CE I EE EPS RPS I I I ISS RISERS EI A IT 2 IE BOOS A I ITE TIE CEE 
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INHX8M 


This format produces one 8-bit hexadecimal file with a low-byte/high-byte 
combination. Since each address can only contain 8 bits in this format, all 
addresses are doubled. File extensions for the object code are “.OBJ.” This 
format is useful for transferring PIC16C5X series object code to third party 
EPROM programmers. 


The difference between this format and Inhx16 is the word length and the 
high/low byte order. Inhx8m has 8-bit words (two hexadecimal digits) with 
the low byte first, rather than 16-bit words (four hexadecimal digits) with the 
high byte first. 


8-bit Word Format: 


Each data record begins with a 9 character prefix and ends with a 2 charac- 
ter checksum. Each record has the following format: 


‘-BBAAAATTHHHH....HHHCC 
where, 


BB a two-digit hexadecimal byte count representing the number of data 
words that appear on the line. 


AAAA a four-digit hexadecimal address representing the starting address 
for the data record. 


TT a two-digit record type that will always be '00' except for the end-of- 
file record which is set to '01'. 


HH a two-digit hexadecimal data word. 


CC a two-digit hexadecimal checksum that’s the two's compliment of the 
sum of all preceding bytes in the record including the prefix. 


16-bit Word Format: 


The 16-bit word format is basically the same as the 8-bit word format. The 
difference is that the hexadecimal data word is four digits. The byte count 
(BB), however, is based on 16-bit words. 


SS RIS SB SE CE ESS I SDS ES LM SELL TS SE TE SS I AERA OEETS 
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MPSIM Commands 


The following two tables contain condensed information from Chapters 4 and 
5 and are printed here for your convenience. The first table contains MPSIM 
commands in alphabetical order and the second table lists MPSIM com- 
mands grouped by function. 


AB Abort session. 


AD data_area,{O|X|B|D)},#digits Add data_area to view screen, showing 
data_area in octal, hexadecimal, Binary or 
Decimal radix with #digits. 


B address Set breakpoint at address. 


B data_area {=|>|<|>=|<=|/=} value Break when data_area matches the condition 
given by the operator (=,>,<,>=,<=, /=) and value. 


BC [address| data_area] Clear breakpoint at address or involving 
data_area. If you don’t supply address or 
data_area, Clear all break points. 


C #breakpoints | Continue executing, ignoring #breakpoints 
breakpoint occurrences. 


[pin [high, low] | [- ]]] Command allows you to assign a clock to an I/O 
pin, and the number of cycles that it should be held 
high and low. 


Display all active break points. 


address1,address2 Delete code from memory address1 to 
address2. 


addressi1[,address2] Display program memory from address1 to 
address2. The code displays in both the current 
radix and mnemonics. If you don’t supply 
address2, the |/O lines display at address1. 


[f[alt-key [pin, event]J]/[ - ]] Assign an asynchronous event to an Alt-key. 


symbol Delete symbol from symbol table. 





(Cont.) 
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DM address1,address2 Display the code from address1 to address2. 
The code displays only in the current radix. 


DP Display all patches. 


DR Display all registers, W register, flags, stack. 








DS Display symbol table. 





DV data_area Delete data_area from view screen. 


DW {E|D} Enable/Disable watchdog timer. 
























DX Display current trace parameters. 

E address Execute program from beginning address. If you 
don’t supply address, MPSIM begins executing at 
the current program count. 
EE address Modify data EE memory address on PIC16C84. 


F register Display/modify contents of file register. 





FI [[file, memory_addr, Insert the next value from file into file_reg when 
file_reg [,n]]/[-]J] the current program counter equals memory_addr. 





FM addrl, addr2, pattern Fill memory from addr1 to addr2 with pattern. 
GE filename Get MPSIM commands from filename. 


GO Reset the PIC 16/17 Microcontroller and execute 
from start. 


GS symbol,value, type Generate symbol with value and type. 
type can be file, bit(file), label or 
literal. 


Display help screen. 


IA address Display/modify code at address. The code 
displays in both the current radix and mnemonics. 


address, instruction insert instruction at address. 







IP [time | step] Inject stimulus according to time or step count. 


Load and execute journal file. 


(Cont.) 


2 erp SETTER TET A ET EP RE AO AEG ETT ADO I I ET EERE RISE IT TIRE III DTT TE IESE OT 28 EROS ID IS ITE ELEN SE ST LTE EE ST TC SSE STE TET SIO 
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LO filename format Load object file filename with format into 
program memory. Listing file is also loaded at this 
time. 


| LS filename Load symbol file £i1ename into internal symbol 
table. 


M address Display/modify code at address. The code 
displays only in the current radix. 


NV Clears view screen. 


O filename format Output modified object code to filename using 
format. 


P {54|55|71...} Choose Microcontroller number. Default is 55. 


Q Quit session. 


RA Restore all: patch table, symbol table and break 
points. 


Reset elapsed time and step count. 
Restore patches to original instructions. 
Simulates a Power-On Reset. 


Display/modify processor cycle time (the default is 
2 microseconds). 


data_area Display/modify data_area. 


addressl1,address2,register Search code from addressi1 to address? for 
an instruction with register. Thesearch 
criteria must be in the current radix. 


address1,address2, instruction Search code from address1 to address2 for 
an instruction. The search criteria must be in 
mnemonics. 


addressl1,address2, instruction Search program memory from address to 
address2 for instruction. The instruction 
must be in the current radix. 


{O| X|D} Set Input/Output radix to Octal, heXadecimal or 
Decimal. 





(Cont.) 





© 1994 Microchip Technology Inc. DS30027H - page 115 


MPSIM USER’S GUIDE 


[address] Single step execution beginning at address. If 
you don’t supply address, MPSIM executes the 
next sequential instruction. 


filename Load stimulus file filename. 


[address1,address2] Set trace to print only those instructions located 
between addresses address1 and address2. lf 
you don’t supply the addresses, MPSIM assumes 
full memory. 


[ #instruction] Trace the next #instruction instructions & 
display if valid. If you don’t supply 
#instruction, MPSIM traces until encountering 
a break or until you press any key. 


[ filename| PRN] Open/Close trace output file or write trace to 
printer. 


[register] Set trace to print only when register is 
accessed. If you don’t supply register, MPSIM 
assumes any register. 


register,min_value,max_value Set trace to print only when register is 
accessed and its value is between min_value 
and max_value. 


data_area,{O|X|B|D},#digits Change the radix and/or number of digits for 
data_area onthe view screen. The new 
representation is in octal, nexadecimai, Binary or 
Decimal radix with #digits. 


V data_area,{O|X|B|D},#digits Create view screen, showing data_area in 
octal, hexadecimal, Binary or pecimal radix with #digits. 


W Display/modify contents of W register. 


ZM addressi1,address2 Zero program memory from address to 
address2. 


Clear patch table. 


Set all registers to 0. 





Zero elapsed time counter to 0. 


Pressing <RETURN> at the % prompt reexecutes the last command entered. 
Thus, you can use commands such as SS more easily. 


a a ES EE A AA AE ET RO EP ST EA TS TE TEE SS SSL FS EIT TT EET TIED 
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Loading and Saving LO filename format 


LS filename 


O filename format 


Inspecting and Modifying 
Program Memory IA address 


M address 


SI address1, address2, instruction 


File Registers and Pins FF register 
W 


SE data_area 


ZR 
Timers ZT 
RE 
SC 
Display Functions DR 


DM addressi1, address2 


Load object file filename with format into 
program memory. Listing file is also 
loaded at this time. 


Load symbol file £i1ename into internal 
symbol table. 


Output modified object code to filename 
using format. 


Display/modify code at address. The 
code displays in both the current radix 
and mnemonics. 


Display/modify code at address. The 
code displays only in the current radix. 


Search code from address1 to 
address2 for aninstruction. The search 
criteria must be in mnemonics. 

SM address1,address2, instruction 
Search program memory from address1 
to address2 for instruction. The 
instruction must be in the current radix. 
ZM addressl1,address2 Zero program 
memory from address 1 t0 address2. 


Display/modify contents of file register. 
Display/modify contents of W register. 
Display/modify data_area. | 

SF address1, address2, register 
Search code from address to 
address2 for an instruction with 
register. Thesearch criteria must be 
in the current radix. 

Set all registers to 0. 

Zero elapsed time counter to 0. 


Reset elapsed time and step count. 


Display/modify processor cycle time (the 
default is 2 microseconds). 


Display all registers, W register, flags, 
stack. 


Display the code from address1 to 
address2. The code displays only in the 
current radix. 


(Cont.) 
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Execute and Tract 


Break Points 


View Screen 
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E address 


C #breakpoints 


SS [address] 


TC [#instruction] 


TA [address1, address2] 


TR [register] 


TR register, min_value, max_value 


DX 
B address 


B data_area {=|>|<|>=|<=| /=} value 


BC [address| data_area] 


C #breakpoints 


DB 


V data_area, {O|X|B|D}, #digits 





Execute program from beginning 
address. If youdon’tsupply address, 
MPSIM begins executing at the current 
program count. 


Continue executing, ignoring 
#breakpoints break point occurrences. 


Single step execution beginning at 
address. lf youdon’tsupply address, 
MPSIM executes the next sequential 
instruction. 


Tracethenext #instruction 

instructions & display if valid. If you don’t 
supply #instruction, MPSiMtraces until 
encountering a break or until you press 
any key. 


Set trace to print only those instructions 
located between addresses address1 
and addressz2. If you don’t supply the 
addresses, MPSIM assumes full memory. 


Set trace to print only when register is 
accessed. If you don’t supply register, 
MPSIM assumes any register. 


Set trace to print only when register is 
accessed and its value is between 
min_value andmax_value. 


Display current trace parameters. 
Set break point at address. 


Break when data_area matches the 
condition given by the operator 
(=,>,<,>=,<=, /=)and value. 


Clear break point at address or 
involving data_area. If you don’t supply 
address or data_area, Clear all break 
points. 


Continue executing, ignoring 
#breakpoints break point occurrences. 


Display all active break points. 
Create view screen, showing data_area 


in octal, hexadecimal, Binary or Decimal 
radix with #¢digits. 


(Cont.) 
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NV Clears view screen. 


AD data_area, {O| X|B|D},#digits Add data_area to view screen, showing 
data_area in octal, hexadecimal, Binary or 
Decimal radix with #digits. 


DV data_area Deiete data_area from view screen. 


TY data_area,{O|X|B|D},#digits | Change the radix and/or number of digits for 
data_area onthe view screen. The new 
representation is in octal, hexadecimal, Binary 
or Decimal radix with #digits. 


Miscellaneous SR {O| X|D} Set Input/Output radix to Octal, heXadecimal or 


Decimal. 
P {54|55|71|...} Choose Microcontroller number. Default is 55. 
IP [TIME | STEP] inject stimulus according to time or step count. 
GE filename Get MPSIM commands from filename. 
Q Quit session. 
AB Abort session. 
ST filename Load stimulus file fi 1ename. 


H Display help screen. 
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Introduction 


I/O Pins 


CPU Model 


MPSIM provides support for more than one family of Microchip 
microcontrollers. This section has been added as an addendum to the 
MPSIM user’s guide to centralize PIC16C5X-specific simulator support. 


The PIC16C5X family consists of the PIC16C54, PIC16C55, PIC16C56, 
PIC16C57, and PIC16C58A. When modifying pins either manually (with the 
SE command) or via the stimulus file, use the following pin names only. 
These are the only ones that MPSIM recognizes as valid !/O pins. Because 
the pinout is device-specific, some pins (for example RCO on a PIC16C54) 
will not be available on all parts in this family. 


- MCLR 

- RTCC 

- RAO-RA3 

- RBO-RB7 

- RCO-RC7 

Reset Conditions 


All reset conditions are supported by MPSIM. 


A Power-On-Reset can be simulated by using the RS instruction. All special- 
purpose registers will be initialized to the values specified in the data sheet. 


A MCLR reset during normal operation or during SLEEP can easily be 
simulated by driving the MCLR pin low (and then high) via the stimulus file or 
by using the SE command or by using DK command. 


A WDT time-out reset is simulated when WDT is enabled (see DW com- 
mand) and proper prescaler is set (by initializing OPTION register appropri- 
ately) and WDT actually overflows. WDT time-out period (with prescale = 1) 
is approximated at 18 ms (to closest instruction cycle multiple). 


The Time-out (TO) and Power-down (PD) bits in the Status register reflect 
appropriate reset condition. This feature is useful for simulating various 
power-up and time out forks in the user code. 
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Sleep 


MPSIM simulates the SLEEP instruction, and will appear “asleep” until a 
wake-up from sleep condition occurs. For example, if the Watchdog timer 
has been enabled, it will wake the processor up from sleep when it times out 
(depending upon the prescaler setting in the OPTION register). 


WDT 


The Watchdog timer is fully simulated in the MPSIM simulator. Because it is 
fuse-selectable on the device, it must be enabled by a separate command 
(see the DW command) in MPSIM. The period of the WDT is determined by 
the prescaler settings in the OPTION register. The basic period (with 
prescaler = 1) is approximated at 18 ms (to closest instruction cycle multiple). 


Stack 


MPSIM presents an accurate simulation of the hardware stack on the 
PIC16C5X, and additionally provides warning messages if an underflow or 
overflow condition occurs. When a CALL instruction is encountered, or when 
an interrupt has occurred, the value of the PC+ 1 is pushed to the stack, and 
the stack is popped when a RETLW, RETURN, or RETFIE instruction is 
executed. If more than two values are pushed to the stack before it is 
popped, the value will be pushed to the stack, but a warning message will be 
issued, indicating a stack overflow condition. An error message will also be 
generated if the user attempts to pop an empty stack. Popping an empty 
stack will cause the last value popped to be put in the PC. 


Special Registers 


To aid in debugging this device, certain items that are normally not observ- 
able have been deciared as "special" registers. For example, the W register 
is not directly-addressable, but can be added to the viewscreen, by adding 
the special label "W" or "w" with the AD command, just as any register. The 
following is a complete list of "special" registers that can be added to the 
viewscreen and observed or modified. You can add them as you normally 
would any other register declared in your code, specifying any radix to view 


them. 

° W(orw) 
¢ TRISA 

> TRISB 

¢ TRISC 


¢ OPT (the option register) 


It is important not to redefine these special labels. For example, do not define 
the label "W" to be equal to zero in your source code. This will cause the 
special label to be overridden, and "W" will now be the indirect-address 
register (INDO). 
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Peripherals 


Peripherals Supported 


Along with providing core support, the RTCC timer/counter module is fully 
supported. It is fully supported in internal and external clock modes. The 
prescaler is made readable and writable as 'RTCCPRE' symbol. 


It is important to remember that because MPSIM executes on instruction 
cycle boundaries, resolutions below 1 Tcy cannot be simulated. 


MPSIM is a discrete-event simulator where all stimuli are evaluated and all 
response generated at instruction boundaries or Tcy. One Tcy = 4 Tosc 
(where Tosc is input clock). Therefore, there are several events that can not 
be accurately simulated in MPSIM. These fall into two categories: 


¢ Purely asynchronous events 
¢ Synchronous events that occur at Tosc clock boundaries 
Because of this, the following items are not supported in MPSIM: 


¢ TimerO prescaler is capable of accepting clock pulse inputs smaller than 
Tcy, but this can not be simulated. 


In summary, the net result of instruction boundary simulation is that all events 
get synchronized at instruction boundary and events smaller than one 
instruction cycle get lost. 


SR A TSA OH SPE EE PN SS SS CEP CSR IES EE SS FESS SS EE RE EITC ES 
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Introduction 


MPSIM provides support for more than one family of Microchip 
microcontrollers. This section has been added as an addendum to the 
MPSIM user’s guide to centralize PIC16C64-specific simulator support. 


1/O Pins 


The PIC16C64 is a 40-pin device, with many of the I/O pins multiplexed with 
other peripherals (and therefore referred by more than one name). When 
modifying pins either manually (e.g. with the SE command) or via the stimu- 
lus file, use the following pin names only. These are the only ones that 
MPSIM recognizes as valid I/O pins: 


Interrupts 





MCLR 

RAO-RA5 
RBO-RB7 
RCO-RC7 
RDO-RD7 
REO-RE2 


MPSIM version 4.5 or greater supports all interrupts on the PIC16C64: 


TimerO overflow 

Timer1 overflow 

Timer2 

CCP1 

SSP (in SPI mode ONLY) 

Change on Port RB <7..4> 
External interrupt from RBO/INT pin 


Parallel Slave Port 


a A EE EYOTA ERE PEELS SAP ET 2 I I TS ETI EY DSA AE NID BREN OSE ON EET SIE EP NET IE EEE ELLER SIE RATES ESIC SEDER ELE TS ITE EAMES SST AT EEA DESERTS EE DAT LEE HT A LETTE 
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CPU Model 


Reset Conditions 
All reset conditions are supported by MPSIM. 


A Power-On-Reset can be simulated by using the RS instruction. All special- 
purpose registers will be initialized to the values specified in the data sheet. 


A MCLR reset during normal operation or during SLEEP can easily be 
simulated by driving the MCLR pin low (and then high) via the stimulus file or 
by using the SE command or by using DK command. 


A WDT time-out reset is simulated when WDT is enabled (see DW com- 
mand) and proper prescaler is set (by initializing OPTION register appropri- 
ately) and WDT actually overflows. WDT time-out period (with prescale = 1) 
is approximated at 18 ms (to closest instruction cycle multiple). 


The Time-out (TO) and Power-down (PD) bits in the Status register reflect 
appropriate reset condition. This feature is useful for simulating various 
power-up and time out forks in the user code. 


Sleep 


MPSIM simulates the SLEEP instruction, and will appear “asleep” until a 
wake-up from sleep condition occurs. For example, if the Watchdog timer 
has been enabled, it will wake the processor up from sleep when it times out 
(depending upon the prescaler setting in the OPTION register). Another 
example of a wake-up-from-sleep condition, would be Timer1 wake-up from 
sleep. In this case, when the processor is asleep, Timer1 would continue to 
increment until it overflows, and if the interrupt is enabled, will wake the 
processor on overflow and branch to the interrupt vector. 


WDT 


The Watchdog timer is fully simulated in the MPSIM simulator. Because it is 
fuse-selectable on the device, it must be enabled by a separate command 
(see the DW command) in MPSIM. The period of the WDT is determined by 
the prescaler settings in the OPTION register. The basic period (with 
prescaler = 1) is approximated at 18 ms (to closest instruction cycle multiple). 


SE LT SE a a FIST a SS I SPS SSO USS oS ASS I AS SUP TSO WE PSS SSB SSP SESE SSS WEEE 
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Stack 


MPSIM presents an accurate simulation of the hardware stack on the 
PIC16CXX, and additionally provides warning messages if an underflow or 
overflow condition occurs. When a CALL instruction is encountered, or when 
an interrupt has occurred, the value of the PC+ 1 is pushed to the stack, and 
the stack is popped when a RETLW, RETURN, or RETFIE instruction is 
executed. If more than eight values are pushed to the stack before it is 
popped, the value will be pushed to the stack, but a warning message will be 
issued, indicating a stack overflow condition. An error message will also be 
generated if the user attempts to pop an empty stack. Popping an empty 
stack will cause the stack pointer to point to the top of a full stack, and will 
not generate an error message if another pop is initiated. 


Special Registers 


To aid in debugging this device, certain items that are normally not observ- 
able have been declared as “special” registers. _Prescalers and postscalers 
cannot be declared in your code as “registers”, so there are special labels 
that can be added to the view screen. You can add them as you normally 
would any other register declared in your code, specifying any radix to view 
them. 


The following are special items that can be added to the view screen when 
the PIC16C64 has been selected: 


¢ TOPRE - Prescaler for timer0 

¢ 1T1PRE - Prescaler for timer 

¢ T2PRE - Prescaler for timer2 

¢ T2POS - Postscaler for timer2 

¢ CCP1PRE - Prescaler for CCP1 
¢ SPIPRE - Prescaler for SPI 

¢ SSPSR - SSP Shift register 


Please remember that these labels are only available when the PIC16C64 is 
the target processor, and that they cannot be manually modified. 


re PP A PRE PII IS AES IES SS AT RE FS AE SEER ES TEESE IG IY TTI ES DISSE EE NEO OSE ALS AE I TIES IEA ETE EC EOE DE SE SA EI I IES ETE I EEE SENET EE PEE IE TC ETE 
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Peripherals 
Peripherals Supported 


Along with providing core support, the following peripheral modules (in 
addition to general-purpose I/O) are supported: 


¢  TimerO 
¢  Timert 
¢ Timer2 
¢ CCP1 


¢ Parallel Slave Port 
¢ SSP (in SPI Mode only) 


Tcycle Limitation 


It is important to remember that because MPSIM executes on instruction 
cycle boundaries, resolutions below 1 Tcy cannot be simulated. Please see 
the following section for more details concerning the limitations of T-cycle 
simulation. 


MPSIM is a discrete-event simulator where all stimuli are evaluated and all 
response generated at instruction boundaries or Tcy. One Tcy = 4 Tosc 
(where Tosc is input clock). Therefore, there are several events that can not 
be accurately simulated in MPSIM. These fall into two categories: 


¢ Purely asynchronous events 
* Synchronous events that occur at Tosc clock boundaries 
Because of this, the following items are not supported in MPSIM: 


¢ TimerO, Timer1, and Timer2 prescalers are capable of accepting clock 
pulse inputs smaller than Tcy, but these can not be simulated. 


* Capture input pulses can be smaller than one Tcy, but can not be 
simulated. 


¢ PWM output pulse resolution less than 1 Tcy is not supported. 


¢ 8-bit compare will not be supported since the output resolution is limited 
to T cycles 


¢ In unsynchronized counter mode, clock input smaller than Tcy is not 
supported 


¢ The oscillator on RCO/RC1 pins is not supported. The user can, how 
ever, Simply use an external clock input for simulation purposes. 


In summary, the net result of instruction boundary simulation is that all events 
get synchronized at instruction boundary and events smaller than one 
instruction cycle get lost. 
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TIMERO 


TimerO (and the interrupt it can generate on overflow) is fully supported by 
MPSIM, and will increment by the internal or external clock. Clock input must 
have a minimum high time of 1Tcy and a minimum low time of 1Tcy due to 
stimulus file requirements. The prescaler for TimerO is made accessible as 
TOPRE. It can be watched and modified. 


TIMER1 


Timer1 in its various modes is supported by MPSIM, except when running in 
counter mode by an external crystal. The interrupt it can be generated on 
overflow and wake-up from sleep through interrupt are both supported by 
MPSIM. The prescaler for Timer1 is viewable and modifiable as T1PRE. The 
external oscillator on RCO/RC1 is not simulated. The user can simply use a 
clock input (see CK command). 


TIMER2 


Timer2 and the interrupt that can be generated on overflow are fully sup- 
ported by MPSIM, and both the prescaler and postscaler for Timer2 are 
viewable and modifiable (T2PRE and T2POS). 


CCP1 


CAPTURE 


MPSIM fully supports capture and the interrupt generated. The prescaler for 
the CCP module is viewable and modifiable (CCP1PRE). 


COMPARE 


Compare mode, its interrupt, and the special event trigger (resetting Timer1 
by CCP1) are supported in this version of MPSIM. 


PWM 


PWM output (resolution greater than 1Tcy only) are supported in this version 
of MPSIM. 


SSP 


The Synchronous Serial Port is supported in SPI mode only. The shift 
register (SSPSR) can be added to the viewscreen, observed and modified. 
MPSIM currently does not support the I?C™ mode. 
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Introduction 


MPSIM provides support for more than one family of Microchip 
microcontrollers. This section has been added as an addendum to the 
MPSIM user’s guide to centralize PIC16C71-specific simulator support. 


I/O Pins 


The PIC16C71 is an 18-pin device, with some of the I/O pins multiplexed with 
other peripherals (and therefore referred by more than one name). When 
modifying pins either manually (e.g. with the SE command) or via the stimu- 
lus file, use the following pin names only. These are the only ones that 
MPSIM recognizes as valid I/O pins: 


¢ MCLR 
« RAO-RA4 
¢ RBO-RB7 


Additionally, RTCC is also recognized as TimerO (previously RTCC) input, 
i.e. same as RA4. 


Interrupts 


MPSIM supports all interrupts on the PIC16C71: 
¢  TimerO (RTCC) overflow 

¢ Change on Port RB <7..4> 

¢ External interrupt from RBO/INT pin 


¢ A/D interrupt complete 
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CPU Model 


Reset Conditions 
All reset conditions are supported by MPSIM. 


A Power-On-Reset can be simulated by using the RS instruction. All special- 
purpose registers will be initialized to the values specified in the data sheet. 


A MCLR reset during normal operation or during SLEEP can easily be 
simulated by driving the MCLR pin low (and then high) via the stimulus file or 
by using the SE command or by using DK command. 


A WDT time-out reset is simulated when WDT is enabled (see DW com- 
mand) and proper prescaler is set (by initializing OPTION register appropri- 
ately) and WDT actually overflows. WDT time-out period (with prescale = 1) 
is approximated at 18 ms (to closest instruction cycle multiple). 


The Time-out (TO) and Power-down (PD) bits in the Status register reflect 
appropriate reset condition. This feature is useful for simulating various 
power-up and time out forks in the user code. 


Sleep 


MPSIM simulates the SLEEP instruction, and will appear “asleep” until a 
wake-up from sleep condition occurs. For example, if the Watchdog timer 
has been enabled, it will wake the processor up from sleep when it times out 
(depending upon the prescaler setting in the OPTION register). Another 
example of a wake-up-from-sleep condition, would be wake-up due to RBO/ 
INT external interrupt. 


WDT 


The Watchdog timer is fully simulated in the MPSIM simulator. Because it is 
fuse-selectable on the device, it must be enabled by a separate command 
(see the DW command) in MPSIM. The period of the WDT is determined by 
the prescaler settings in the OPTION register. The basic period (with 
prescaler = 1) is approximated at 18 ms (to closest instruction cycle multiple). 


Stack 


MPSIM presents an accurate simulation of the hardware stack on the 
PIC16CXX, and additionally provides warning messages if an underflow or 
overflow condition occurs. When a CALL instruction is encountered, or when 
an interrupt has occurred, the value of the PC+ 1 is pushed to the stack, and 
the stack is popped when a RETLW, RETURN, or RETFIE instruction is 
executed. If more than eight values are pushed to the stack before it is 
popped, the value will be pushed to the stack, but a warning message will be 
issued, indicating a stack overflow condition. An error message will also be 
generated if the user attempts to pop an empty stack. Popping an empty 
stack will cause the stack pointer to point to the top of a full stack, and will 
not generate an error message if another pop is initiated. 


) 
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Special Registers 


To aid in debugging this device, certain items that are normally not observ- 
able have been declared as “special” registers. Prescalers and postscalers 
cannot be declared in your code as “registers”, so there are special labels 
that can be added to the view screen. You can add them as you normally 
would any other register declared in your code, specifying any radix to view 
them. 


The following are special items that can be added to the view screen when 
the PIC16C71 has been selected: 


¢ TOPRE - Prescaler for timerO 


Please remember that these labels are only available when the PIC16C71 is 
the target processor, and that they cannot be manually modified. 


Peripherals 
Peripherals Supported 


Along with providing core support, the following peripheral modules (in 
addition to general-purpose |/O) are supported: 


¢ TimerO 
¢« A/D module (limited) 


Tcycle Limitation 


It is important to remember that because MPSIM executes on instruction 
cycle boundaries, resolutions below 1 Tcy cannot be simulated. Please see 
the following section for more details concerning the limitations of T-cycle 
simulation. 


MPSIM is a discrete-event simulator where all stimuli are evaluated and all 
response generated at instruction boundaries or Tcy. One Tcy = 4 Tosc 
(where Tosc is input clock). Therefore, there are several events that can not 
be accurately simulated in MPSIM. These fall into two categories: 


¢ Purely asynchronous events 


¢ Synchronous events that occur at Tosc clock boundaries 
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Because of this, the following items are not supported in MPSIM: 


¢ TimerO prescaler is capable of accepting clock pulse inputs smaller than 
Tcy, but this can not be simulated. 


In summary, the net result of instruction boundary simulation is that all events 
get synchronized at instruction boundary and events smaller than one 
instruction cycle get lost. 


TIMERO 


TimerO (and the interrupt it can generate on overflow) is fully supported by 
MPSIM, and will increment by the internal or external clock. Clock input must 
have a minimum high time of 1Tcy and a minimum low time of 1T cy due to 
stimulus file requirements. The prescaler for TimerO is made accessible as 
TOPRE. It can be watched and modified. 


A/D Converter 


All the registers, timing function and interrupt generation are implemented. 
The simulator, however, does not load any meaningful value into A/D result 
register (ADRES) at the end of a conversion. Use the Fl command to load 
the ADRES register from a file for simulation purposes. 
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Introduction 


MPSIM provides support for more than one family of Microchip 
microcontrollers. This section has been added as an addendum to the 
MPSIM user’s guide to centralize PIC16C74-specific simulator support. 


I/O Pins 


The PIC16C74 is a 40-pin device, with many of the !/O pins multiplexed with 
other peripherals (and therefore referred by more than one name). When 
modifying pins either manually (e.g. with the SE command) or via the stimu- 
lus file, use the following pin names only. These are the only ones that 
MPSIM recognizes as valid 1/O pins: 


Interrupts 





MCLR 

RAO-RA5 
RBO-RB7 
RCO-RC7 
RDO-RD7 
REO-RE2 


MPSIM version 4.5 or greater supports all interrupts on the PIC16C74: 


TimerO overflow 

Timer overflow 

Timer2 

CCP1 

CCP2 

SSP (in SPI mode ONLY) 

Change on Port RB <7..4> 
External interrupt from RBO/INT pin 
A/D interrupt complete 

USART 


Parallel Slave Port 
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CPU Model 


Reset Conditions 
All reset conditions are supported by MPSIM. 


A Power-On-Reset can be simulated by using the RS instruction. All special- 
purpose registers will be initialized to the values specified in the data sheet. 


A MCLR reset during normal operation or during SLEEP can easily be 
simulated by driving the MCLR pin low (and then high) via the stimulus file or 
by using the SE command or by using DK command. 


A WDT time-out reset is simulated when WDT is enabled (see DW com- 
mand) and proper prescaler is set (by initializing OPTION register appropri- 
ately) and WDT actually overflows. WDT time-out period (with prescale = 1) 
is approximated at 18 ms (to closest instruction cycle multiple). 


The Time-out (TO) and Power-down (PD) bits in the Status register reflect 
appropriate reset condition. This feature is useful for simulating various 
power-up and time out forks in the user code. 


Sleep 


MPSIM simulates the SLEEP instruction, and will appear “asleep” until a 
wake-up from sleep condition occurs. For example, if the Watchdog timer 
has been enabled, it will wake the processor up from sleep when it times out 
(depending upon the prescaler setting in the OPTION register). Another 
example of a wake-up-from-sieep condition, would be Timer1 wake-up from 
sleep. In this case, when the processor is asleep, Timer1 would continue to 
increment until it overflows, and if the interrupt is enabled, will wake the 
processor on overflow and branch to the interrupt vector. 


WDT 


The Watchdog timer is fully simulated in the MPSIM simulator. Because it is 
fuse-selectable on the device, it must be enabled by a separate command 
(see the DW command) in MPSIM. The period of the WDT is determined by 
the prescaler settings in the OPTION register. The basic period (with 
prescaler = 1) is approximated at 18 ms (to closest instruction cycle multiple). 


Stack 


MPSIM presents an accurate simulation of the hardware stack on the 
PIC16CXxX, and additionally provides warning messages if an underflow or 
overflow condition occurs. When a CALL instruction is encountered, or when 
an interrupt has occurred, the value of the PC+ 1 is pushed to the stack, and 
the stack is popped when a RETLW, RETURN, or RETFIE instruction is 
executed. If more than eight values are pushed to the stack before it is 
popped, the value will be pushed to the stack, but a warning message will be 
issued, indicating a stack overflow condition. An error message will also be 
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generated if the user attempts to pop an empty stack. Popping an empty 
stack will cause the stack pointer to point to the top of a full stack, and will 
not generate an error message if another pop is initiated. 


Special Registers 


To aid in debugging this device, certain items that are normally not observ- 
able have been declared as “special” registers. Prescalers and postscalers 
cannot be declared in your code as “registers”, so there are special labels 
that can be added to the view screen. You can add them as you normally 
would any other register declared in your code, specifying any radix to view 
them. 


The following are special items that can be added to the view screen when 
the PIC16C74 has been selected: 


¢ TOPRE - Prescaler for timerO 

¢ T1PRE - Prescaler for timer 

¢ T2PRE - Prescaler for timer2 

¢ T2POS - Postscaler for timer2 

* CCP1PRE - Prescaler for CCP1 
¢ CCP2PRE - Prescaler for CCP2 
¢ SPIPRE - Prescaler for SPI 

¢ SSPSR - SSP Shift register 


Please remember that these labels are only available when the PIC16C74 is 
the target processor, and that they cannot be manually modified. 


Peripherals 
Peripherals Supported 


Along with providing core support, the following peripheral modules (in 
addition to general-purpose !/O) are supported: 


¢  TimerO 
¢  Timert 
-  Timer2 
* CCP1 
¢* CCP2 


¢ Parallel Slave Port 
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¢ SSP (in SPI Mode only) 
¢« A/D module (limited) 
¢ USART (limited) 


Tcycle Limitation 


It is important to remember that because MPSIM executes on instruction 
cycle boundaries, resolutions below 1 Tcy cannot be simulated. Please see 
the following section for more details concerning the limitations of T-cycle 
simulation. 


MPSIM is a discrete-event simulator where all stimuli are evaluated and all 
response generated at instruction boundaries or Tcy. One Tcy = 4 Tosc 
(where Tosc is input clock). Therefore, there are several events that can not 
be accurately simulated in MPSIM. These fall into two categories: 


¢ Purely asynchronous events 
¢ Synchronous events that occur at Tosc clock boundaries 
Because of this, the following items are not supported in MPSIM: 


¢ TimerO, Timer1, and Timer2 prescalers are capable of accepting clock 
pulse inputs smaller than Tcy, but these can not be simulated. 


¢ Capture input pulses can be smaller than one Tcy, but can not be 
simulated. 


¢ PWM output pulse resolution less than 1 Tcy is not supported. 


¢ §8-bit compare will not be supported since the output resolution is limited 
to T cycles 


¢ In unsynchronized counter mode, clock input smaller than Tcy is not 
supported 


¢ The oscillator on RCO/RC1 pins is not supported. The user can, how 
ever, simply use an external clock input for simulation purposes. 


In summary, the net result of instruction boundary simulation is that all events 
get synchronized at instruction boundary and events smaller than one 
instruction cycle get lost. 


TIMERO 


TimerO (and the interrupt it can generate on overflow) is fully supported by 
MPSIM, and will increment by the internal or external clock. Clock input must 
have a minimum high time of 1Tcy and a minimum low time of 1Tcy due to 
stimulus file requirements. The prescaler for TimerO is made accessible as 
TOPRE. It can be watched and modified. 
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TIMER1 


Timer in its various modes is Supported by MPSIM, except when running in 
counter mode by an external crystal. The interrupt it can be generated on 
overflow and wake-up from sleep through interrupt are both supported by 
MPSIM. The prescaler for Timer1 is viewable and modifiable as T1PRE. The 
external oscillator on RCO/RC1 is not simulated. The user can simply use a 
clock input (see CK command). 


TIMER2 


Timer2 and the interrupt that can be generated on overflow are fully sup- 
ported by MPSIM, and both the prescaler and postscaler for Timer2 are 
viewable and modifiable (T2PRE and T2POS). 


CCP1 and CCP2 
CAPTURE 


MPSIM fully supports capture and the interrupt generated. The prescaler for 
the CCP module is viewable and modifiable (CCP1PRE). 


COMPARE 


Compare mode, its interrupt, and the special event trigger (resetting Timer if 
CCP1 and starting A/D Conversion if CCP2) are supported in this version of 
MPSIM. 


PWM 


PWM output (resolution greater than 1Tcy only) are supported in this version 
of MPSIM. 


SSP 


The Synchronous Serial Port is supported in SPI mode only. The shift 
register (SSPSR) can be added to the viewscreen, observed and modified. 
MPSIM currently does not support the I?C mode. 


USART 


Timing and interrupt generation is supported. Baud rate generator is sup- 
ported. Reading and writing of the registers are supported but actual receive 
or transmit operation is not simulated. 


A/D Converter 


All the registers, timing function and interrupt generation are implemented. 
The simulator, however, does not load any meaningful value into A/D result 
register (ADRES) at the end of a conversion. Use the Fl command to load 
the ADRES register from a file for simulation purposes. 
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MPSIM provides support for more than one family of Microchip 
microcontrollers. This section has been added as an addendum to the 
MPSIM user’s guide to centralize PIC16C74-specific simulator support. 


The PIC16C84 is an 18-pin device, with some of the !/O pins multiplexed with 
other peripherals (and therefore referred by more than one name). When 
modifying pins either manually (e.g. with the SE command) or via the stimu- 
lus file, use the following pin names only. These are the only ones that 
MPSIM recognizes as valid I/O pins: 





- MCLR 
- RAO-RA4 
- RBO-RB7 


Additionally, RTCC is also recognized as Timer0 (previously RTCC) input, 
i.e. same as RA4. 


MPSIM supports all interrupts on the PIC16C71: 
¢ TimerO overflow 

¢ Change on Port RB <7..4> 

¢ External interrupt from RBO/INT pin 

¢« EEPROM write complete 
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CPU Model 


Reset Conditions 
All reset conditions are supported by MPSIM. 


A Power-On-Reset can be simulated by using the RS instruction. All special- 
purpose registers will be initialized to the values specified in the data sheet. 


A MCLR reset during normal operation or during SLEEP can easily be 
simulated by driving the MCLR pin low (and then high) via the stimulus file or 
by using the SE command or by using DK command. 


A WOT time-out reset is simulated when WDT is enabled (see DW com- 
mand) and proper prescaler is set (by initializing OPTION register appropri- 
ately) and WDT actually overflows. WDT time-out period (with prescale = 1) 
is approximated at 18 ms (to closest instruction cycle multiple). 


The Time-out (TO) and Power-down (PD) bits in the Status register reflect 
appropriate reset condition. This feature is useful for simulating various 
power-up and time out forks in the user code. 


Sleep 


MPSIM simulates the SLEEP instruction, and will appear “asleep” until a 
wake-up from sleep condition occurs. For example, if the Watchdog timer 
has been enabled, it will wake the processor up from sleep when it times out 
(depending upon the prescaler setting in the OPTION register). Another 
example of a wake-up-from-sleep condition, would be due to RBO/INT 
interrupt wake-up. 


WDT 


The Watchdog timer is fully simulated in the MPSIM simulator. Because it is 
fuse-selectable on the device, it must be enabled by a separate command 
(see the DW command) in MPSIM. The period of the WDT is determined by 
the prescaler settings in the OPTION register. The basic period (with 
prescaler = 1) is approximated at 18 ms (to closest instruction cycle multiple). 


Stack 


MPSIM presents an accurate simulation of the hardware stack on the 
PIC16CXX, and additionally provides warning messages if an underflow or 
overflow condition occurs. When a CALL instruction is encountered, or when 
an interrupt has occurred, the value of the PC+ 1 is pushed to the stack, and 
the stack is popped when a RETLW, RETURN, or RETFIE instruction is 
executed. If more than eight values are pushed to the stack before it is 
popped, the value will be pushed to the stack, but a warning message will be 
issued, indicating a stack overflow condition. An error message will also be 
generated if the user attempts to pop an empty stack. Popping an empty 
stack will cause the stack pointer to point to the top of a full stack, and will 
not generate an error message if another pop is initiated. 
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Special Registers 


To aid in debugging this device, certain items that are normally not observ- 
able have been declared as “special” registers. Prescalers and postscalers 
cannot be declared in your code as “registers”, so there are special labels 
that can be added to the view screen. You can add them as you normally 
would any other register declared in your code, specifying any radix to view 
them. 


The following are special items that can be added to the view screen when 
the PIC16C84 has been selected: 


¢ TOPRE - Prescaler for timerO 


Please remember that these labels are only available when the PIC16C84 is 
the target processor, and that they cannot be manually modified. 


Peripherals 
Peripherals Supported 


Along with providing core support, the following peripheral modules (in 
addition to general-purpose I/O) are supported: 


¢  TimerO 
« EEPROM data memory 


Tcycle Limitation 


It is important to remember that because MPSIM executes on instruction 
cycle boundaries, resolutions below 1 Tcy cannot be simulated. Please see 
the following section for more details concerning the limitations of T-cycle 
simulation. 


MPSIM is a discrete-event simulator where all stimuli are evaluated and all 
response generated at instruction boundaries or Tcy. One Tcy = 4 Tosc 
(where Tosc is input clock). Therefore, there are several events that can not 
be accurately simulated in MPSIM. These fall into two categories: 


¢ Purely asynchronous events 
¢ Synchronous events that occur at Tosc clock boundaries 
Because of this, the following items are not supported in MPSIM: 


¢ TimerO prescaler is capable of accepting clock pulse inputs smaller than 
Tcy, but this can not be simulated. 


In summary, the net result of instruction boundary simulation is that all events 
get synchronized at instruction boundary and events smaller than one 
instruction cycle get lost. 
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TIMERO 


TimerO (and the interrupt it can generate on overflow) is fully supported by 
MPSIM, and will increment by the internal or external clock. Clock input must 
have a minimum high time of 1Tcy and a minimum low time of 1Tcy due to 
stimulus file requirements. The prescaler for TimerO is made accessible as 
TOPRE. It can be watched and modified. 


EEPROM Data Memory 


The EEPROM data memory is fully simulated. The registers and the read/ 
write cycles are fully implemented. The write cycle time is approximated to 10 
ms (to nearest instruction cycle multiple). 


Please note that wheras the write to EEPROM is supported, the simulator 
does not check for "the valid instruction sequence". The simulator does, 
however, simulate functions of WRERR and WREN control bits in the 
EECON1 register. 
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